home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 018a / mta_vf35.zip / MTADOCEN.DOC < prev    next >
Text File  |  1993-02-22  |  442KB  |  8,424 lines
  1. ╔══════════════════════════════                 ┌─────────────────┐
  2. ║ MTA       Make Them Anything                  │    D.I.S.P.     │────┐
  3. ║           Convert Compressed                  │                 │░░░░│
  4. ╟──────────────────────────────                 │                 │░░░░│
  5. ║ (c) 1993  Robert W.van Hoeven                 │ Dutch           │░░░░│
  6. ╟──────────────────────────────                 │   Independent   │░░░░│
  7. ║ Release : 15.35                               │     ShareWare   │░░░░│
  8. ║ Rel.Date: February 22th, 1993                 │       Programmer│░░░░│
  9. ╠══════════════════════════════                 └─────────────────┘░░░░│
  10. ║                                               |    │░░░░░░░░░░░░░░░░░│
  11. ║ │ MTA.EXE / MTM.EXE                           |    └─────────────────┘
  12. ║ │ MTL.EXE / MTZ.EXE                           |       ┌─────┐        |
  13. ║ │ MTA.CTL / MTA.CHx                           |       │░░░░░│        |
  14. ║ │                                             |       └──┬──┘        |
  15. ║ │ MTAOVR.EXE / MTAOVR.OVR (*)                 |     ┌────┴────┐      |
  16. ║ │                                             ------││││││ ═══│-------
  17. ║ │ Lines starting with '│' are                       └─────────┘
  18. ║ │ changes to release 15.30
  19. ║ │
  20. ║ │
  21. ╠═══════════════════════════════
  22. ║ Address: Robert W. van Hoeven
  23. ║          PO. Box 131
  24. ║          1170 AC  Badhoevedorp
  25. ║          Nederland / Holland
  26. ╚═══════════════════════════════
  27.  
  28. ╔═══════════════════════ (*) OVERLAY FILES ════════════════════════════╗
  29. ║ MTAOVR.EXE and MTAOVR.OVR are files that make the overlayed version  ║
  30. ║ of MTA. These files are available in a separate package which can be ║
  31. ║ found under the name MTAOVvvv.eee (where vvv has the same number as  ║
  32. ║ the last 3 digits of this archive (e.g. F10, F11, F32) and eee is    ║
  33. ║ the extension.                                                       ║
  34. ╚══════════════════════════════════════════════════════════════════════╝
  35.  
  36. ╔══════════════════════════════════════════════════════════════════════╗
  37. ║ READ THE MTA.NEW DOCUMENTATION, THERE ARE SOME CHANGES IN PARAMETERS ║
  38. ║ AND OPTIONS !                                                        ║
  39. ╚══════════════════════════════════════════════════════════════════════╝
  40.  
  41.  ┌───────┬─────────────────────────────────────────────────────────────┐
  42.  │   0   │ Table of contents                                           │
  43.  └───────┴─────────────────────────────────────────────────────────────┘
  44.  
  45.  1 ----    General information
  46.   1.1      Copyrights and License Agreement
  47.   1.2      Newer versions and contacting the author
  48.  
  49.  2 ----    Package description and requirements
  50.   2.1      Preface
  51.   2.2      Requirements
  52.   2.3      Included files
  53.   2.4      History
  54.  
  55.  3 ----    Installation description
  56.   3.1      Installation
  57.    3.1.1   Installation of the software
  58.    3.1.2   The overlay mechanism
  59.   3.2      Archivers
  60.    3.2.1   General remarks and suggestions on archivers
  61.    3.2.2   Remarks on ARC
  62.    3.2.3   Remarks on PAK
  63.    3.2.4   Remarks on ZIP
  64.    3.2.5   Remarks on PKPAK/PKUNPAK
  65.    3.2.6   Remarks on DWC
  66.    3.2.7   Remarks on ZOO
  67.    3.2.8   Remarks on LHarc
  68.    3.2.9   Remarks on LArc
  69.    3.2.10  Remarks on MD
  70.    3.2.11  Remarks on ARJ
  71.    3.2.12  Remarks on HYPER
  72.    3.2.13  Remarks on PKLITE
  73.    3.2.14  Remarks on GIFLITE
  74.    3.2.15  Remarks on JPEG
  75.    3.2.16  Remarks on GIFTEST
  76.    3.2.17  Remarks on SQZ
  77.   3.3      MTA.CTL
  78.    3.3.1   Basic statements
  79.    3.3.2   Statements that define the environment that MTA uses (paths)
  80.    3.3.3   Statements that define the logging
  81.    3.3.4   Statements that define the selection of files
  82.    3.3.5   Statements that define the resulting files
  83.    3.3.6   Your own (new) compressor
  84.    3.3.7   Statements that define the various exits (hooks) in MTA
  85.    3.3.8   Statements that are useful to Bulletin Board Systems/SysOp's
  86.    3.3.9   Special statements
  87.    3.3.10  Statements available when using a registered version
  88.   3.4      Diskette option
  89.   3.5      KeyBoard control
  90.   3.6      Running multiple copies of MTA at the same time
  91.   3.7      Compression of single executable files (PKLITE)
  92.   3.8      The MTA tag-window
  93.   3.9      MTA and unattended operations
  94.   3.10     TICK-files and related material
  95.   3.11     FES, yet another TICK-clone ?
  96.   3.12     Special ARC considerations
  97.   3.13     Using newer versions of archivers
  98.   3.14     Lo-tek functions, calling MTA as shell of MTA
  99.   3.15     TEC files
  100.  
  101.  4 ----    Run-time information
  102.   4.1      Command-line parameters
  103.    4.1.1   Command-line parameters that stand on their own
  104.    4.1.2   Command-line parameters that overrule/toggle/disable MTA.CTL
  105.    4.1.3   Command-line parameters with a special usage
  106.   4.2      Aborting MTA
  107.   4.3      LOG file
  108.   4.4      Errors
  109.  
  110.  5 ----    Version information and credits
  111.   5.1      The BETA-team
  112.   5.2      Credits
  113.   5.3      Version history
  114.   5.4      Copyright, Trademarks
  115.  
  116.  ┌───────┬─────────────────────────────────────────────────────────────┐
  117.  │   1   │ General information                                         │
  118.  └───────┴─────────────────────────────────────────────────────────────┘
  119.  
  120.  1.1 Copyrights and License Agreement
  121.  ────────────────────────────────────
  122.  
  123.  - Users of the MTA-package must accept this disclaimer of warranty:
  124.  
  125.  - The  MTA-package  is  supplied  as  is.   The  author  disclaims  all
  126.    warranties, expressed or implied, including, without limitation,  the
  127.    warranties of merchantability  and of fitness  for any purpose.   The
  128.    author assumes  no liability  for damages,  direct or  consequential,
  129.    which may result from the use of the MTA-package;
  130.  
  131.  - The  MTA-package  is  a  "shareware  program"  and is provided at  no
  132.    charge to the user for evaluation.   Feel free to share it with  your
  133.    friends,  but  please  do  not  give  it  away  altered or as part of
  134.    another  system.   The  essence  of  "user-supported"  software is to
  135.    provide personal  computer users  with quality  software without high
  136.    prices, and yet to provide  incentive for programmers to continue  to
  137.    develop new products.
  138.  
  139.  - If  you find  this program  useful and  find that  you are  using and
  140.    continue the  use of  the MTA-package  after a  30 days trial period,
  141.    you must register the MTA-package as described below;
  142.  
  143.  - Non-commercial can get a license for the usage up to this release  of
  144.    the MTA-package for  a small amount  of money. Look  into the details
  145.    in  REGISTER.MTA.  Previous  registered  users  will  receive  a  big
  146.    reduction to upgrade to the  newer versions. These users should  look
  147.    into the details in UPGRADE.MTA.   For Non-commercial users there  is
  148.    a POSSIBILITY to submit to one of the special contracts as  explained
  149.    in the file REGISTER.MTA.
  150.  
  151.  - Commercial usage of  MTA will cost somewhat  more. Also, a so  called
  152.    'closed' Bulletin  Board System  (a system  where the  user must  pay
  153.    direct to the  SysOp to get  full access) is  has to pay  more than a
  154.    Non-commercial  user.  Both  types  of  users  should  look  into the
  155.    details in REGISTER.MTA;
  156.  
  157.  - The registration of the MTA-package will license ONE copy for use  on
  158.    any computer at any  one time, as long  as the usage confirms  to the
  159.    type of registration you have done (so NON-commercial usage when  you
  160.    have a non-commercial license);
  161.  
  162.  - Anyone  distributing  the  MTA-package  for any kind of remuneration
  163.    must  first   contact  the   Author   at   the  address   above   for
  164.    authorization.
  165.  
  166.  - You are  encouraged  to  pass a copy   of the MTA-package  along   to
  167.    your friends  for  evaluation.   Please  encourage  them to  register
  168.    their copy if they find that they can use it;
  169.  
  170.  - Support  on  MTA,  when  used  in  a  non-commercial environment,  is
  171.    available  by  means  of  written  letters  or by entering the inter-
  172.    national echomail area DISP;
  173.  
  174.  - Problems and suggestions can be entered in the FidoNet <tm>  Echomail
  175.    conference <tm> called DISP (international). Entering this echo  does
  176.    not  exclude  you  of  the  duty  to register the MTA-package, though
  177.    users who evaluate the product can enter the echo for questions;
  178.  
  179.  - The  MTA-package, all  programs, the  documentation and support-files
  180.    is  copyrighted  1990,93  by  Robert  W.  van  Hoeven,  PO.  Box 131,
  181.    Badhoevedorp 1170AC, Holland. All  rights are reserved. You  may copy
  182.    this  package  for  backup  purposes.  Also  you  may  copy and share
  183.    unmodified copies of the whole package, providing that the  copyright
  184.    notice    is    reproduced    and    included    on    all    copies.
  185.    Excluded from this statement  are the support-files written  by other
  186.    authors.  Please  refer  to  the  documentation of these programs for
  187.    copyrights and license agreements;
  188.  
  189.  - It  is  forbidden  to  modify,  adapt,  translate, reverse  engineer,
  190.    decompile  and/or  disassemble  the  software  in  the   MTA-package.
  191.    Patching the medium at  places that carry the  software is seen as  a
  192.    program change and is also forbidden. It is forbidden to create a  so
  193.    called 'bypass' to skip the original introduction screens and  delay.
  194.    Also it is forbidden  to use such a  'bypass' unless supplied by  the
  195.    author (Robert W. van Hoeven) himself;
  196.  
  197.  - Performing  any  of  the  illegal  actions as stated in the previous
  198.    lines,  is  a  theft  and  no  fair  play  to  the  author  and, more
  199.    important, to the registered users;
  200.  
  201.  - Bulletin Board  Systems that distribute  the MTA package  can convert
  202.    the WHOLE package  to any archive-system  they like but  all original
  203.    files must  be included  in the  new archive.  The MTA-package on the
  204.    Bulletin Board  can contain  at the  most 2  extra files. These files
  205.    can only be  a commercial for  that Bulletin Board  and/or validation
  206.    data that is presented  as a service to  all users and shall  have no
  207.    other functions;
  208.  
  209.  - After  the normal  trial period  of 30  days, you  must register  the
  210.    soft- ware (see REGISTER.MTA) or you must remove it from your PC;
  211.  
  212.  - Comments,  suggestions  and  bug  reports  are  welcome  and will  be
  213.    answered as soon I have the time  to do so. You can send me  a letter
  214.    of leave  a NetMail  <tm> message  named to  Rob Van.hoeven (mind the
  215.    point)  on  node  2:512/100  (RA  Support, Monster, Holland, SysOp is
  216.    Reinier de Groot).  When you want to send me normal mail, address  it
  217.    to:   Robert  W.  van  Hoeven,  PO.  Box  131,  1171 AC Badhoevedorp,
  218.    Holland;  Also  you  can  enter  messages  in  the  FidoNet <tm> DISP
  219.    Echomail <tm> area;
  220.  
  221.  
  222.  1.2 Newer versions and contacting the author
  223.  ───────────────────────────────────────────────────────────────────────
  224.  The newest version of  MTA is always available  at the DISP-HQ on  node
  225.  2:512/100.  MTA  is  also  distributed  thru  a  number of DISP support
  226.  nodes.  There are three ways of obtaining newer versions of MTA:
  227.  
  228.  
  229.  - Logging on at DISP-HQ or a support node
  230.    Look into the file SUPPORT.MTA for a full list of support nodes;
  231.  
  232.  - Logging on to a SDS node
  233.    MTA is distributed thru SDS/SDN, but only big minors (x.10, x.20  and
  234.    so on) and majors (14.01, 15.01  and so on) are submitted to  the SDS
  235.    distribution point in Holland;
  236.  
  237.  - Logging on to your own BBS;
  238.    Chances  are,  that  you  will  find  an older version (international
  239.    users) because it will take some time for the new version to  'bleed'
  240.    thru the net;
  241.  
  242.  - Update service;
  243.    You can enter a special update service (read REGISTER.MTA).
  244.  
  245.  
  246.  If you think you have found problems in MTA, or in any other case,  you
  247.  wish to contact the author, you can send me:
  248.  
  249.  - A letter to the address you can find in the header of this file;
  250.  
  251.  -  A  NetMail  <tm>  message  to  Rob Van.hoeven (please mind the point
  252.    between Van and Hoeven) at 2:512/100 or (better) 2:512/100.5;
  253.  
  254.  - A Message in the FidoNet <tm> DISP echomail <tm> area;
  255.  
  256.  ┌───────┬─────────────────────────────────────────────────────────────┐
  257.  │   2   │ Package description and requirements                        │
  258.  └───────┴─────────────────────────────────────────────────────────────┘
  259.  
  260.  2.1 Preface
  261.  ───────────────────────────────────────────────────────────────────────
  262.  MTA is a program that can  be helpful with the job to  convert archives
  263.  (compressed files) from one archive-system (ZIP, ARJ, LZH and such  are
  264.  called archive-systems) to another one.
  265.  
  266.  The   conversion   from   archive-systems    is   something   that   is
  267.  done frequently  on  BBS  systems.  Different  users  do  uploads   for
  268.  files  created  in   various   archive-systems.   The  SysOp    (System
  269.  Operator   of a  BBS) will  make these   files available  in only   one
  270.  system so all  users who  download   one  or  more  files,  only   need
  271.  one archive program to decompress the files.
  272.  
  273.  When  a   normal  user   visits  various   BBS's  that   all have their
  274.  own archive system,   she/he will   also get   a mixture   of different
  275.  files, created in different archive-systems. In this case MTA can  also
  276.  help.
  277.  
  278.  There a tons of features available in MTA. Some of them will only  have
  279.  a meaning for a SysOp, some of  them only for the normal user and  many
  280.  of them for  both. Users can  automatically remove files  from archives
  281.  (many BBS's add  headers and/or files  to the archive  as advertisement
  282.  for the BBS),  SysOp's can add  them, both can  scan for viri  (in many
  283.  different  ways).  There  are  options  to  convert  a  single  file, a
  284.  complete directory (with  or without sub-directories),  complete drives
  285.  and a  special feature  to convert  all files  on a  diskettes from one
  286.  system to another (while the user  won't have to worry that the  target
  287.  files will not fit on the diskette). The list can go on for hours.
  288.  
  289.  The MAJOR   benefit of   MTA is,   that it   treats ANY   of the   most
  290.  known  archivers  with   the  same   service.  Other   programs may  be
  291.  smaller  but only  treat a certain archive-system  for  the full  100%.
  292.  MTA  is  made   in  a   way   that   YOU   can   decide   what   output
  293.  (archive-system)  should  be  created  without   having  to  search for
  294.  better programs  when  you  swap from  one system  to  another. Another
  295.  benefit of  MTA   is the  up-to-date status  of the   program. For more
  296.  than 3  years   now, I  have   managed to  update MTA  at the same time
  297.  (and  sometimes  earlier)  you  got  hold   of  a  new  version of your
  298.  archive-program.  And even when you are  not served within the  minute,
  299.  you  can  always  use  the  special  routines  in MTA  that implement a
  300.  'user-type'  of  archive   program  (based  on  the  extension   of the
  301.  archives).
  302.  
  303.  MTA's documentation  is NOT  easy. It  is a  large text.  There are  so
  304.  many options that can be   useful for you. The   best way to start   is
  305.  to read  everything one  (without   the description  of   the options),
  306.  then  take a ASCII-editor, import chapter   3 and start  to create  the
  307.  configuration  file,  line  by  line,  option  by  option.  If you have
  308.  completed the   setup, you nearly  don't have   to look at  it  anymore
  309.  for a long  time, so take your time.
  310.  
  311.  
  312.  2.2 Requirements
  313.  ───────────────────────────────────────────────────────────────────────
  314.  MTA requires:      - PC XT/AT/386/486 (or more)
  315.                     - At least 400K free memory but it depends on the
  316.                       archiver(s) you use (NON OVERLAYED VERSION);
  317.                     - At least 200K free memory but it depends on the
  318.                       archiver(s) you use (OVERLAYED VERSION);
  319.                     - DOS 3.xx and higher;
  320.                       (tested with 4Dos 4.0, should work with lower
  321.                       versions);
  322.                     - DOS 2.xx ONLY when registered. In this case, a
  323.                       customized version will be created;
  324.                     - HDU optional
  325.                     - Mouse optional
  326.                     - One or more virus-scanners (optional)
  327.                     - The original (de)compression programs. MTA does
  328.                       NOT contain the compression/decompression
  329.                       routines;
  330.                     - The  original  GIF  conversion  programs that are
  331.                       supported by MTA;
  332.  
  333.  
  334.  2.3 Included files
  335.  ───────────────────────────────────────────────────────────────────────
  336.  The package includes : MTA.EXE         The main program
  337.                         MTA.CH1         The chained tag-menu module
  338.                         MTA.CH2         The chained help-menu module
  339.                         MTM.EXE         The maintenance program
  340.                         MTL.EXE         The list program
  341.                         MTA_DIR.EXE     The directory utility
  342.                         MTA_CRC.EXE     The VALIDATE caller
  343.                         MTA__BAT.EXE    A SFX with examples of batches
  344.                         MTA__UTL.EXE    A SFX with additional utilities
  345.  
  346.  Besides this normal and complete package, there is an additional  file,
  347.  containing MTAOVR.EXE and MTA.OVR. These are the files that are  needed
  348.  to run MTA in overlayed mode.
  349.  
  350.  
  351.  
  352.  2.4 History
  353.  ───────────────────────────────────────────────────────────────────────
  354.  MTA is  now 3  years old.  It started  with version  4.01 (first public
  355.  release). Releases 1, 2  and 3 were called  MTZ and could only  convert
  356.  ZIP-files. With  release 13,  MTA changed  from freeware  to shareware.
  357.  With release  14, MTA  added some  extra options  for BBS's  and became
  358.  able to output some of  the text to a modem  (so MTA could be run  as a
  359.  shell under the BBS or a protocol-driver). With release 15, a new  type
  360.  of compressed files is supported.  These are GIF files. Release  15 can
  361.  support  the  conversion  of  GIF  files.  Also,  within  release 15, a
  362.  MS/Windows version of MTA will  be released AND (finally) the  setup of
  363.  the configuration  file will  change from  a ASCII-file  to a  windowed
  364.  (full-screen) setup program  (not in 15.01,  15.01 is a  forced release
  365.  because of the upcoming ZIP 2.xx).
  366.  
  367.  I will try to  keep MTA  as  up-to-date as possible. Every  few  months
  368.  or so, new  versions  of  archive programs   hit the  market. Some   of
  369.  these versions  contain  new   algorithms  and  also  contain   changes
  370.  in the  internal structure.  Up to  now, I   was able  to release a new
  371.  version of MTA only   a few  days  after  the final   release of   such
  372.  versions   (and  sometimes  earlier,  based   on  the   beta-versions).
  373.  Needless to say  that it is a hell of a job to keep informed about  all
  374.  the changed.
  375.  
  376.  ┌───────┬─────────────────────────────────────────────────────────────┐
  377.  │   3   │ Installation description                                    │
  378.  └───────┴─────────────────────────────────────────────────────────────┘
  379.  
  380.  3.1 Installation
  381.  ───────────────────────────────────────────────────────────────────────
  382.  MTA is  not an  easy program  to install.  There are  numerous features
  383.  that can be used.  Also, there are no  specific guidelines for a  quick
  384.  install of the program,  but in the next  chapters I will try  to guide
  385.  you thru the installation in a structured way. Both  new  and  advanced
  386.  users should also take a look at  any  included *.TEC file. These files
  387.  (if present) will give a wider description  of  a  specific topic which
  388.  has caused some questions in the past.
  389.  
  390.  
  391.  3.1.1 Installation of the software
  392.  ───────────────────────────────────────────────────────────────────────
  393.  The first step is  the installation of the  (program) files. This is  a
  394.  very easy step if  you observe all the  following rules. The next steps
  395.  are described with a hard-disk system in mind:
  396.  
  397.  - Decide which directory you want to use. MTA can find its own  support
  398.    files in three possible ways (in the following order):
  399.  
  400.    - In the current directory;
  401.    - The directory containing MTA.EXE (DOS 3.xx and higher only) or any
  402.      other program name if you have renamed  MTA.EXE to something else.
  403.      The same goes for the overlay version;
  404.    - The DOS PATH (DOS 2.xx and higher);
  405.  
  406.    Either use an existing directory or create a new directory that  will
  407.    be used for the  installation of MTA (in  the second case, add  it to
  408.    the DOS PATH,  so the call  to MTA.EXE can  be done from  anywhere on
  409.    the disk);
  410.  
  411.  - Place MTA.EXE, MTA.CH1, MTA.CH2, MTL.EXE, MTM.EXE and MTZ.EXE in  the
  412.    selected directory.  If you  don't want  to use  MTL, MTM and/or MTZ,
  413.    you  can  always   remove  them  later.   MTA.CH1  and  MTA.CH2   are
  414.    (sometimes) needed  by MTA.  MTA.CH1 contains  the interactive  pick-
  415.    list to select files  from a large list,  MTA.CH2 is called when  you
  416.    want help information about  the command-line options. When  you have
  417.    obtained the overlayed version of MTA, you must also copy  MTAOVR.EXE
  418.    and MTAOVR.OVR to the selected directory. All programs CAN be renamed
  419.    to anything you like (e.g.  delete the non-overlayed MTA.EXE and  re-
  420.    name  the  overlayed  MTAOVR.EXE  to  MTA.EXE) but the files MTA.CH1,
  421.    MTA.CH2 can NOT be renamed. Also when you rename the overlay  version
  422.    (MTAOVR.EXE), you must give the  filename-part (not the extension) of
  423.    the overlay file (MTAOVR.OVR) the SAME name (so  rename MTAOVR.EXE to
  424.    BLURB.EXE, in that case, rename MTAOVR.OVR to BLURB.OVR);
  425.  
  426.  - Copy the  included example of  MTA.CTL to the  same directory as  the
  427.    MTA program files. This example file must be changed later on to  you
  428.    own environment and needs. For now, leave it unchanged;
  429.  
  430.  - MTA can  also look for  an environment variable  called MTA. You  can
  431.    add a line  in AUTOEXEC.BAT with  the value 'SET  MTA=[path]' (do not
  432.    code the  quotes and  replace [path]  with the  name of the directory
  433.    where MTA.EXE/CH1/CH2/OVR/CTL are;
  434.  
  435.  - NEVER  use compression  programs like  PKLITE, SHRINK  or DIET on the
  436.    executable files inside  the MTA package.  They must stay  unaltered.
  437.    The programs that are called within MTA (archivers, exits) can,  from
  438.    MTA's point of view, be compressed with these programs. If you insist
  439.    on using the least possible space, you CAN compress  the MTA.CH1/CH2,
  440.    MTL.EXE, MTM.EXE and MTZ.EXE files with PKLITE  or any other program
  441.    that you like;
  442.  
  443.  - Be sure to have the DOS program  SUBST.COM/EXE inside your DOS path.
  444.    This program comes with your release  of  DOS and without them,  MTA
  445.    can do  less of the  conversion  than when  you  have them available.
  446.    As you will see  later, you  need  special  options to set to a value
  447.    to let  MTA make use of this program (so you can still have  them  on
  448.    the drive without MTA using them). Unless  you  have  a special setup
  449.    networks and such), you can rest  assure that you can  use  the SUBST
  450.    program along with MTA, unless you use specialized software that will
  451.    not match with SUBST usage;
  452.  
  453.  - When  installing the  MTA files,  also take  some time  to see  which
  454.    archive programs  you have  where (write  them down,  because you can
  455.    use this  info when  you create  MTA.CTL). Also  take a  look at  the
  456.    versions  you  run  of  these  programs.   The  next chapters will go
  457.    into  specific  details  for  every  supported  archiver.  In case of
  458.    difficulty  or  just  to  stay  up-to-date,  you should try to obtain
  459.    the highest version that is mentioned in the documentation;
  460.  
  461.  - When using the overlayed  version  of  MTA, you  should read the next
  462.    paragraph for more details on how to setup the overlay environment;
  463.  
  464.  
  465.  3.1.2 The overlay mechanism
  466.  ────────────────────────────────────────────────────────────────────────
  467.  There is also an overlay version of MTA. This means  that only part  of
  468.  the code will be active and available in conventional memory (the  part
  469.  of  memory  up  to  640K)  and  the  remaining parts of the code can be
  470.  loaded into  memory when  a certain  part is  needed. Overlays are only
  471.  useful when a program will not  have to access all parts of  the coding
  472.  in  a  short  time.  The  more  coding  is not needed concurrently, the
  473.  bigger the overlay and the smaller the part of conventional memory  the
  474.  program needs.
  475.  
  476.  When a program  is written, the  author will always  try to search  for
  477.  the  best  result  on  a  large  number of implementations, but not all
  478.  situations can be dealt with. Because of these special situations,  MTA
  479.  includes a number of options to make the overlay mechanism as  flexible
  480.  as possible. To change the  overlay mechanism means that you  must know
  481.  how it works by default. When MTA is loaded, it will try to  initialize
  482.  the overlay manager first. This is done in the following manner:
  483.  
  484.  - The program  will search for  the overlay-file. The  location it will
  485.    search is the location where the EXE-file is found. The name must  be
  486.    the same as  the filename-part (without  extension) of the  EXE-file,
  487.    so when you rename MTAOVR.EXE to MTA.EXE, you must  also  rename  the
  488.    MTAOVR.OVR file to TA.OVR. This mechanism works for all  DOS releases
  489.    from version 3.0 and higher. Lower versions of  DOS (1.x and 2.x) can
  490.    not work in  this manner and  you need to  set the location  and name
  491.    overlay-file with help of an environment variable (see later);
  492.  
  493.  - If  the overlay-file  is found,  the program  will initialize  it and
  494.    will examine the memory.  The overlay-manager need some  conventional
  495.    memory  and  it  can  store  the  remaining  part of the overlay (the
  496.    not-active part) in  expanded memory (EMS)  if that is  available and
  497.    contains enough  free memory.  The size  of the  part of conventional
  498.    memory is variable (though it can not  be too small) and is set to  a
  499.    good average  (by default).  The size  of the  part of  EMS memory is
  500.    fixed  for  a  given  release  of  the program. The more conventional
  501.    memory  that  is  assigned  to  the  overlay  buffer,  the better the
  502.    performance  of  the  program  but  the less memory (conventional) is
  503.    available. If the  overlay part can  not be loaded  into EMS (because
  504.    it isn't there or there isn't enough free memory in EMS), it will  be
  505.    left  on  disk  and  parts  of  the  coding  must be loaded from disk
  506.    (slower!) when they are needed;
  507.  
  508.  - If  the overlay-managers  fails to  install the  overlay, the program
  509.    will abort. In general, the failing will be the result of:
  510.  
  511.    - The OVR-file (the overlay) could not be found;
  512.  
  513.    - Not enough conventional memory available to load the overlay;
  514.  
  515.    - Invalid (old) EMS drivers;
  516.  
  517.    - I/O errors on the overlay-file
  518.  
  519.    - Conflicts  between  other  programs  that  use EMS or  conventional
  520.      memory (TSR's, device drivers);
  521.  
  522.  In general, when you do  nothing about the overlay-manager and  you run
  523.  under DOS 3.xx  or higher, you  will have a  solid running program.  If
  524.  you have problems (see above) or  you want to optimize the program  for
  525.  better  thruput,  you  can  (must)  alter the overlay management. These
  526.  changes must be  made with help  of environment variables  (see the DOS
  527.  SET command). Many people asked why you can't put these changes  inside
  528.  the control-file.  That is  not possible,  because the  parsing of  the
  529.  control-file itself is  an overlayed part  of the coding.  You need the
  530.  overlay before you can  access the control file.  That is why you  must
  531.  make use of environment variables. The following environment  variables
  532.  are tested for:
  533.  
  534.  MTAOVROL : This environment variable can  be used to point to the  name
  535.             and/or location of the overlay-file.  You can use it in  two
  536.             ways:
  537.  
  538.             (1) SET MTAOVROL=F:\RAMDRIVE\
  539.             (2) SET MTAOVROL=C:\BBS\PRG\MTA.OVR
  540.  
  541.             In  the  first  case  (1)  you  point  to the directory that
  542.             contains the overlay-file. The  name of the overlay-file  is
  543.             generated from  the program-name  (minus the  extension), so
  544.             when  you  have  MYMTA.EXE,  you  must put MYMTA.OVR in this
  545.             directory  first.  The  directory-name  MUST  end with a '\'
  546.             otherwise the  overlay-manager will  assume RAMDRIVE  as the
  547.             name of the overlay-file and will search for it in F:\.
  548.  
  549.             In the second  case (2) you  point to the  location AND name
  550.             of the overlay-file. In this case the overlay-file can  have
  551.             a  complete  different  name.  So  it  is  valid to call the
  552.             program MTAHELL.EXE  and the  overlay MTAOVR.OVR  if you use
  553.             SET  MTAOVROL=C:\BBS\PRG\MTAOVR.OVR.  This  option  is  also
  554.             needed when you run under DOS 1.xx or 2.xx;
  555.  
  556.             The most  common usage  of this  environment variable  is to
  557.             put  the  overlay-file  on  a  RAM-disk (fast access) and to
  558.             deny the  usage of  EMS for  the overlay  (because you  have
  559.             better candidates for EMS usage).
  560.  
  561.  MTAOVRUE : This environment variable can have 2 values, either Y or  N.
  562.             The program will only test if the value 'N' is used (so  SET
  563.             MTAOVRUE=N). If this is  the case, the overlay  manager will
  564.             not  use  EMS  for  the  overlay-file  and  access  to   the
  565.             overlay-file is done on disk (see MTAOVROL);
  566.  
  567.  MTAOVRBS : This environment  variable can  be used  to alter  (enlarge)
  568.             the  overlay  buffer  in  conventional memory. The program's
  569.             default will give a good  average, but when memory is  not a
  570.             problem  (conventional  memory),  you  can  make the overlay
  571.             buffer bigger and  gain some speed  in the program  thruput.
  572.             To  see  which  value  you  should  set,  you should run the
  573.             program without this option first. Inside the log (you  must
  574.             activate the log),  you can find  the default value  for the
  575.             overlay buffer. You  can make it  smaller but don't  make it
  576.             smaller  than  the  current  size  minus  8192 otherwise the
  577.             overlay-manager  could  fail.  You  can  make  it bigger but
  578.             don't make it too big  (experiment with small steps and  see
  579.             if the  performance gets  better). SET  MTAOVRBS=100000 will
  580.             allocate  100.000  bytes  of  conventional  memory  for  the
  581.             overlay buffer;
  582.  
  583.  MTAOVRPS : This environment  variable can  be used  to alter  (enlarge)
  584.             the 'prohibition area'.  This area is  a part of  the normal
  585.             overlay buffer. It is used to store recently accessed  parts
  586.             of the code. The code  will remain as long as  possible over
  587.             here. If the code is  accessed again, it doesn't have  to be
  588.             loaded from the  overlay-file but can  come from this  area.
  589.             The value you supply with  this variable should not be  less
  590.             than 2. The default  is 3 (buffersize /  3). You can try  to
  591.             gain some speed by making  the overlay buffer larger and  to
  592.             set this  value to  2. The  default gives  a good average in
  593.             combination with most overlay buffers;
  594.  
  595.  In general (DOS version equal or higher than 3.xx, unaltered names  for
  596.  the program-file and overlay-file, enough  EMS memory or a fast  disk),
  597.  you can use the default values and don't have to set these  environment
  598.  variables.
  599.  
  600.  MTA's overlayed version  is available as a separate package (MTAOVxxx).
  601.  It is advised to use the  overlay  version when the remaining memory is
  602.  very low (when running  MTA  under a BBS door like FileDoor <tm>.
  603.  
  604.  
  605.  
  606.  3.2 Archivers
  607.  ───────────────────────────────────────────────────────────────────────
  608.  In the next chapters I will give some personal advise and some  remarks
  609.  on the various archivers that  are available and that MTA  can support.
  610.  If  you  are  an  inexperienced  user,  you can obtain some information
  611.  about archivers you haven't looked at, if you are a pro, you will  find
  612.  some remarks on the  various archivers that have  to deal with the  way
  613.  MTA converts from and to these kind of systems.
  614.  
  615.  
  616.  3.2.1 General remarks and suggestions on archivers
  617.  ───────────────────────────────────────────────────────────────────────
  618.  This  chapter   (3.2.1)  contains   some  PERSONAL   information  about
  619.  archivers in general. If you don't  know all the systems or if  you are
  620.  still in  search for  a better  one, this  chapter can  guide you  in a
  621.  certain way.  I won't start a discussion about the information in  this
  622.  chapter, neither with  the authors (beta-testers)  nor with the  users,
  623.  remember it  is my  personal point  of view,  after looking  at all  of
  624.  them. For starters, I  will URGE to say  that MTA supports ALL  archive
  625.  systems in the  BEST possible way,  so the fact  that I am  not using a
  626.  certain system does  not mean that  MTA does not  support it for  100%.
  627.  Some  other  vendors  supply  conversion  programs  from  all  (or one)
  628.  systems to all  (or one) other  system. Please be  warned that most  of
  629.  these programs ar  written with a  certain archive system  in mind. MTA
  630.  is not such a  program. I neither sell  nor develop any archive  system
  631.  myself  so  MTA  can  look  as  'objective'  as possible to any archive
  632.  system.
  633.  
  634.  The question 'which is the best  archive system for my situation' is  a
  635.  question that is  asked many times.  I can not  give 100% OK  answer to
  636.  this question but I can try. First you must ask yourself one  question.
  637.  WHY, besides  gaining disk  space,   should I  use an  archive program.
  638.  Here are some guidelines:
  639.  
  640.  -a) I  need as  much files  in on  my disks,  so HIGH compression is my
  641.      major goal;
  642.  
  643.  -b) I  want  to  create  compressed  files very quickly because I  have
  644.      either a slow machine or much archives to maintain;
  645.  
  646.  -c) I  want  to  make  my  archives  'transparent'  to  other types of
  647.      operating systems (called 'platforms' with a difficult word);
  648.  
  649.  -d) I need  to archive (and  store) files on  diskette that are  bigger
  650.      than my highest diskette format;
  651.  
  652.  -e) I want  some sort of  version control, so  when I add  a file to an
  653.      archive, any previous file with  the same name inside that  archive
  654.      must be kept as a backup (older level);
  655.  
  656.  I  am  sure  there  are  some  other  guidelines  to follow. For one, I
  657.  personally  like  a  good  and  bug-free  archive  program  with a good
  658.  feedback from users of  vendor when needed. But  let us take the  given
  659.  guidelines (a) to (e) and see what COULD be best for you. In the  given
  660.  order:
  661.  
  662.  -a) Most archivers can  compress to a very  small format but there  are
  663.      three groups  that differ  in size.  The first  group contains  ZIP
  664.      (2.xx),  LZH  (2.xx)  and  ARJ  (2.xx)  in  a random order. It is a
  665.      matter of 1  to 3 percent  depending on the  kind of files.  LZH is
  666.      free (with source-code) which can  be a bonus but also  a drawback.
  667.      The second group  contains ZOO (2.xx),  HYPER (25) and  PAK (2.xx).
  668.      ZOO 2.1x  is somewhere  between the  first and  second group, other
  669.      differ in speed and options. The remaining systems are combined  as
  670.      the third group;
  671.  
  672.  -b) When speed is  the main interest, ZIP  is your goal. LZH  (2.xx) is
  673.      also good and some of the  older systems can work fast. There  is a
  674.      rule that says, the higher  the compression, the more time  it will
  675.      take to  compress. Where  ARJ, ZIP  and LZH  make very com- pressed
  676.      files (within a the 5% bounds), ZIP outruns the others;
  677.  
  678.  -c) If  you want  to make  'portable' archives,  the choices are small.
  679.      Excluding OS/2  and to  my knowledge,  only LZH  and ZOO can create
  680.      transparent archives. ARJ  is working on  one and the  archives are
  681.      already prepared to be transparent;
  682.  
  683.  -d) For  this  feature  you  need  the so called multi-volume  support.
  684.      Only ARJ and ZIP (2.xx) support multi-volume support (MTA does  not
  685.      by the way);
  686.  
  687.  -e) Version  control is  an option  in demand  by programmers.  ARJ and
  688.      ZOO include  version control.  ZOO in  a somewhat  nicer way as ARJ
  689.      but   it  has  just  been  included  in  ARJ,  so there is room for
  690.      improvements;
  691.  
  692.  I think  that most  of the  users need  a combination  of -a)  and -b).
  693.  From the text you  can see that, unless  you need special tricks,  ARJ,
  694.  LZH and  ZIP are  the first  you should  try. If  you love many options
  695.  (and have a fast machine), you should take a look at ARJ.  If you  love
  696.  a good  simple interface  and very  speedy results,  ZIP is  your first
  697.  target and when  you want something  of both (and  the sources, AND  no
  698.  registration), LZH  would be  nice, though  it has  some drawbacks  (no
  699.  path-information, no  multi-volume). I  will skip  to ZIP  2.xx because
  700.  the AV-code is finally possible for non-USA users.
  701.  
  702.  
  703.  3.2.2 Remarks on ARC
  704.  ───────────────────────────────────────────────────────────────────────
  705.  MTA supports : All ARC versions up to 6.02
  706.  
  707.  There are no  special tricks concerning  ARC. When destination  is ARC,
  708.  FULL recursive support  is available if  you use the  SubstDrive option
  709.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  710.  nature of ARC's recursive support.
  711.  
  712.  MTA is  NOT able  to detect  incoming encrypted  ARC-files. There is no
  713.  indication in the ARC whatsoever that an ARC-file is encrypted.  Please
  714.  be careful ! MTA IS able  to unARC encrypted ARC-files when you  supply
  715.  the correct switches to MTA;
  716.  
  717.  If you receive  files from the  newer (7.xx) version  of ARC (SEA)  but
  718.  you don't own ARC  7.xx, you can use  the UNARCPath option in  MTA.EXE.
  719.  This option can point to either ARCE.EXE or XARC.EXE. In that case  you
  720.  can decompress the  files and convert  them to another  system that you
  721.  CAN support.
  722.  
  723.  
  724.  3.2.3 Remarks on PAK
  725.  ───────────────────────────────────────────────────────────────────────
  726.  MTA supports : All PAK versions up to 2.51
  727.  
  728.  There are a  few things to  keep in mind  when using a  PAK version. If
  729.  you still use GSARC (the old PAK),  skip as fast as you can to  a newer
  730.  level (GSARC support will be removed from MTA, somewhere in 1993).
  731.  
  732.  There are some special tricks concerning PAK. When destination is  PAK,
  733.  FULL recursive support  is available if  you use the  SubstDrive option
  734.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  735.  nature of PAK's recursive support.
  736.  
  737.  When adding comments to the PAK file (AutoComment option), up to  64000
  738.  bytes  are  allowed,  although  this  seems  to  be  more  than PAK can
  739.  support.
  740.  
  741.  MTA  is  NOT  able  to  detect  incoming  encrypted  PAK-files, see the
  742.  remarks on ARC files.
  743.  
  744.  NoGate Consulting  have released  a PAK  2.5x with  ZIP-support inside.
  745.  MTA is  NOT able  to use  PAK as  a substitution  for PKWare's ZIP. You
  746.  MUST use PKZIP/PKUNZIP to compress and decompress ZIP files !
  747.  
  748.  
  749.  3.2.4 Remarks on ZIP
  750.  ───────────────────────────────────────────────────────────────────────
  751.  MTA supports : All ZIP versions up to 2.01
  752.  
  753.  When using   ZIP files   (as destination),   you must   remember to set
  754.  the  correct  compression  switches  in   the  ZIPCompression option in
  755.  MTA.CTL.  You can not (of  course) use a switch  that is not  supported
  756.  with your current  version  of  ZIP.   Also  be  sure  to  upgrade   to
  757.  the  highest  possible  version.  MTA  versions  up   to  14.57 contain
  758.  upgrade  support   to  upgrade  from  older   ZIP  (0.xx) to  newer ZIP
  759.  (1.xx)  formats. MTA 15.01 and up  still contain  upgrade support   but
  760.  now  for the   1.xx to  2.xx  versions of ZIP. MTA   will ignore  newer
  761.  ZIP  archives if you still  use an older ZIP version.
  762.  
  763.  MTA  is  able  to  detect  and  process  both  encrypted  ZIP-files and
  764.  ZIP-files  with  Authenticity  Verification  set  to  ON. MTA will skip
  765.  encrypted ZIP-files when no password is supplied to MTA.
  766.  
  767.  From 14.50 and  on, conversion of  volume-labels from and  to ZIP files
  768.  is available in MTA.
  769.  
  770.  
  771.  3.2.5 Remarks on PKPAK/PKUNPAK
  772.  ───────────────────────────────────────────────────────────────────────
  773.  MTA supports : All PKPAK/UNPAK versions up to 3.61
  774.  
  775.  There is  nothing special  in this  support. To  go along  with S.E.A.,
  776.  PKPAK/PKUNPAK  format  is  not  supported  as  destination, nor are the
  777.  (archive) comments inside a PKware created ARC-file;
  778.  
  779.  MTA is NOT able to  detect incoming encrypted PKPAK-files. There  is no
  780.  indication  in  the  ARC  whatsoever  that  a  PKPAK-file is encrypted.
  781.  Please be  careful !  MTA IS  able to  unPAK encrypted PKPAK-files when
  782.  you supply the correct switches to MTA.
  783.  
  784.  
  785.  3.2.6 Remarks on DWC
  786.  ───────────────────────────────────────────────────────────────────────
  787.  MTA supports : DWC version 5.10A
  788.  
  789.  No support for included directories.  You can set the type  of compress
  790.  (average, good) by means of the DWCCompression option in MTA.CTL.
  791.  
  792.  There are some special tricks concerning DWC. When destination is  DWC,
  793.  FULL recursive support  is available if  you use the  SubstDrive option
  794.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  795.  nature of DWC's recursive support.
  796.  
  797.  MTA is able  to detect and  process DWC files  that are encrypted.  MTA
  798.  will skip an encrypted DWC-file when no password is supplied to MTA.
  799.  
  800.  
  801.  3.2.7 Remarks on ZOO
  802.  ───────────────────────────────────────────────────────────────────────
  803.  MTA supports : ZOO version 2.10
  804.  
  805.  There is nothing special in  this support. Full recursive and  relative
  806.  path support is  available. MTA also  supports ZOO 2.01  'extended' and
  807.  the new ZOO 2.10 with very small target files (high compression).
  808.  
  809.  You  can  set  high  compression  for  ZOO  by using the ZOOCompression
  810.  option with a value of h.
  811.  
  812.  When adding comments to the ZOO file (AutoComment option), up to  64000
  813.  bytes  are  allowed,  although  this  seems  to  be  more  than ZOO can
  814.  support.
  815.  
  816.  
  817.  3.2.8 Remarks on LHarc
  818.  ───────────────────────────────────────────────────────────────────────
  819.  MTA supports : All LHarc versions up to 2.13E
  820.  
  821.  There are some special tricks concerning LZH. When using LZH  (in/out),
  822.  FULL recursive support  is available if  you use the  SubstDrive option
  823.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  824.  nature of LZH's recursive support.
  825.  
  826.  NEVER use versions 2.03 to 2.06. Please contact me if you want to  know
  827.  the details WHY MTA can not support these versions.
  828.  
  829.  Remember to set the LZHVersion option to the correct value !!!!!!!!!!
  830.  
  831.  
  832.  3.2.9 Remarks on LArc
  833.  ───────────────────────────────────────────────────────────────────────
  834.  MTA supports : LArc version 3.33
  835.  
  836.  MTA supports  LArc as  it can.  There is  no documentation available to
  837.  me, so everything comes from 'the dark'.
  838.  
  839.  There are some special tricks concerning LZS. When using LZS  (in/out),
  840.  FULL recursive support  is available if  you use the  SubstDrive option
  841.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  842.  nature of LZS's recursive support.
  843.  
  844.  
  845.  3.2.10 Remarks on MD
  846.  ───────────────────────────────────────────────────────────────────────
  847.  MTA supports : MDCD version 1.00
  848.  
  849.  MTA supports MDCD. The  not so commonly used  MDCD program can be  used
  850.  both as source and as  target. Although the sources are  available, MTA
  851.  will use the stand-alone program MDCD.EXE for (de)compression.
  852.  
  853.  
  854.  3.2.11 Remarks on ARJ
  855.  ───────────────────────────────────────────────────────────────────────
  856.  MTA supports : ARJ  version 2.39a (probably also upcomming 2.40)
  857.  
  858.  Support for ARJ is rather straight forward. All standard functions  are
  859.  implemented but at  least ARJ 2.22  is needed because  MTA uses the  -+
  860.  option to switch off the SW_ARJ options.
  861.  
  862.  There is no  support for multi-volumes  and neither for  ARJ files with
  863.  backups  inside.  MTA  can  process  them correctly (even with extended
  864.  testing, see later) but it is up  to you what will happen. You can  set
  865.  the ARJCompression option in MTA to  whatever you like. If you add  the
  866.  -jo  switch,  ARJ  will   decompress  the  backup-versions  along   the
  867.  original, renaming the backup-versions.
  868.  
  869.  ARJ files with a security envelope  are supported but MTA will not  add
  870.  comments or files to these files  as with ZIP (ARJ disallows adding  of
  871.  these objects by reporting an invalid security envelope).
  872.  
  873.  ARJ contains the original  archive-name within the archive  itself. MTA
  874.  can use this  name and (optionally)  rename the source-archive  back to
  875.  that original name before conversion start (OriginalARJName option).
  876.  
  877.  Support for  the 2.10  volume labels  is added.  Please remember to put
  878.  the  KeepVolLabel  (/KEEPVL)  option  on  ONLY  in combination with ARJ
  879.  version 2.1x>. If you use ZIP  (1.1x>) and a lower version of  ARJ than
  880.  2.1x, conversion of the volume-labels  will cause ARJ to abort  and the
  881.  converted files to be moved to the error-directory !
  882.  
  883.  
  884.  3.2.12 Remarks on HYPER
  885.  ───────────────────────────────────────────────────────────────────────
  886.  MTA supports : HYPER version 25 (and up)
  887.  
  888.  This nice little  compression program from  Germany, is also  supported
  889.  in MTA. Testing  (to implement the  protocol in MTA)  gave results that
  890.  are in the same order as LHARC.
  891.  
  892.  MTA support the  recursive features in  HYPER. Any commenting  in a HYP
  893.  file is  impossible (yet)  and thus  not supported  by MTA. All comment
  894.  related features will do nothing on a HYP file.
  895.  
  896.  MTA will support HYPER SFX (self extracting archive) files.
  897.  
  898.  Also MTM, MTL and MTZ are changed to reflect the results of the  change
  899.  from or to HYPER and to do maintenance on these files.
  900.  
  901.  
  902.  3.2.13 Remarks on PKLITE
  903.  ───────────────────────────────────────────────────────────────────────
  904.  MTA supports : PKLITE version 1.15 (and up)
  905.  
  906.  It is a little off-topic type of program to be included in MTA, but  it
  907.  is. MTA (and  the selection-menu MTA.CH1)  is changed so  that you easy
  908.  convert  COM/EXE  files  to  compressed  (self-contained) COM/EXE files
  909.  with PKLITE. I think this is a useful bonus (and nothing more) to MTA.
  910.  
  911.  Why not  include LZEXE  you would  ask. The  reasons are  simple (and a
  912.  hint to the author, based on the current version 0.91):
  913.  
  914.  - LZEXE can only directly compress EXE files (COM files need a  special
  915.    conversion); - LZEXE can only go one way;
  916.  
  917.  In the near future I will think about adding the Japanese DIET  program
  918.  into MTA (it can do the same, and more, than PKLITE).
  919.  
  920.  When MTA  works in  (UN)PKLITE mode,  it can  only convert with PKLITE.
  921.  All other files (archives) are not converted.
  922.  
  923.  When MTA  ignores files  in the  selection, there  can be  a number  of
  924.  reasons. These are:
  925.  
  926.  With PKLITE:
  927.  
  928.  - The file is already PKLITE'ed;
  929.  
  930.  - The file is already LZEXE'ed;
  931.  
  932.  - The file is a SFX (Self extracting archive);
  933.  
  934.  With UNPKLITE:
  935.  
  936.  - The file is not PKLITE'ed;
  937.  
  938.  LZEXE files are left, because  it will create problems when  converting
  939.  these programs with PKLITE and when it does NOT create problems,  there
  940.  will be NO gain in size. SFX-files are left for the same reasons.
  941.  
  942.  
  943.  3.2.14 Remarks on GIFLITE
  944.  ───────────────────────────────────────────────────────────────────────
  945.  MTA supports : GIFLITE 1.41 (and up)
  946.  
  947.  With version 15.01,  MTA can also  convert GIF files.  There is support
  948.  for GIFLITE (registered and un-registered) without any drawbacks.
  949.  
  950.  
  951.  3.2.15 Remarks on JPEG
  952.  ───────────────────────────────────────────────────────────────────────
  953.  MTA supports : JPEG 15 (and up)
  954.  
  955.  There are various JPEG implementations. The one from Handmade  Software
  956.  is included for the moment.  The original programs from the  JPEG group
  957.  have reached DISP-HQ to late to be implemented.
  958.  
  959.  
  960.  3.2.16 Remarks on GIFTEST
  961.  ───────────────────────────────────────────────────────────────────────
  962.  MTA supports : GIFTEST 4.0ß
  963.  
  964.  MTA does  not use  any command-line  parameter in  the call to GIFTEST.
  965.  You can add some yourself (using MTA.CTL options and/or a  command-line
  966.  parameter for MTA). MTA is aware of all of the errorlevels that can  be
  967.  returned  by  GIFTEST.  If  you  include  command-line  parameters  for
  968.  GIFTEST that  cause the  GIF-file(s) to  be removed  if they are wrong,
  969.  MTA still try to move the file but without success. The only  'problem'
  970.  in this case, is the warning message you will receive. MTA is aware  of
  971.  all the errorlevels. 5 and 255 are converted to 'decompression  error'.
  972.  When you use  /L on the  GTECOMPRESSION option, be  sure to point  to a
  973.  place  (directory)  that  is  not  'owned'  by  MTA (so NOT the current
  974.  directory).  Use /M to  trigger when the dimensions are  not supported.
  975.  In that case MTA will move the file to the error-directory (lvl 20).
  976.  
  977.  
  978.  3.2.17 Remarks on SQZ
  979.  ───────────────────────────────────────────────────────────────────────
  980.  MTA supports : SQZ version 1.08.2
  981.  
  982.  This is a new compression/decompression program from Sweden. The 1.08.2
  983.  is a BETA test version and should be used with care ! There is  contact
  984.  between the SQZ author (Jonas I Hammarberg) and me, and I will  try  to
  985.  update MTA as soon as possible as there  are  new (changed) versions of
  986.  SQZ that need a change in MTA !
  987.  
  988.  The performance of SQZ is the same or better than ARJ and the new alpha
  989.  of PKZIP (1.93a). The speed  is  somewhere  between ZIP and ARJ, all in
  990.  all it looks very impressive and I have  the intention (if possible) to
  991.  support all functions in SQZ.
  992.  
  993.  MTA does  NOT  support  the  c(omment) option of SQZ because SQZ itself
  994.  (1.08.2) does   not  support  it yet. When  a  new   version  of SQZ is
  995.  released  with this option active, you should not use it in combination
  996.  with MTA 15.21  but  wait  until the explicit support of this option is
  997.  included in  MTA. MTA  is  unable  to  obtain  comments  FROM SQZ files
  998.  (CarryComment 1 and 2  will  work but will use an empty string) but CAN
  999.  add comments to SQZ files.
  1000.  
  1001.  Recursive support is  included  and MTA will always try to compress the
  1002.  files with  the  /p0 switch  (paths 'as-is'). To  use recursive support
  1003.  for source SQZ-files,  the  SUBSTDrive  support  is needed (as with all
  1004.  other archivers).
  1005.  
  1006.  Also MTM, MTL and MTZ are changed to reflect the results of the  change
  1007.  from or to HYPER and to do maintenance on these files.
  1008.  
  1009.  
  1010.  3.3 MTA.CTL
  1011.  ───────────────────────────────────────────────────────────────────────
  1012.  To let MTA  work, you must  create a configuration  file where MTA  can
  1013.  obtain  the  information  it  needs.  This  file  is  called MTA.CTL by
  1014.  default but can have any other  name (in which case you must  assign it
  1015.  to MTA by means of  a command-line option or an  environment variable).
  1016.  You can even have more configuration files for different tasks. If  you
  1017.  call the file  MTA.CTL and place  it as described  in chapter 3.1,  MTA
  1018.  will  find  it  without  the  use  of special forces like command-lines
  1019.  and/or  environment  variables.  In  this  DOCUMENTATION  we refer to a
  1020.  configuration file by its  original name (MTA.CTL). You  can substitute
  1021.  your filename in place.
  1022.  
  1023.  The configuration  file is  a normal  ASCII-file (text  file) which you
  1024.  can create and edit with line-editors like EDLIN or EDIT. You can  make
  1025.  the  file  as  big  as  you  want (by inserting many comment-lines) but
  1026.  remember that the size  has a relation with  the speed of reading  when
  1027.  MTA starts.  Large files will take MTA to do longer over the startup.
  1028.  
  1029.  The general formats of options are:
  1030.  
  1031.  OPTION  parameter parameter parameter .... parameter
  1032.  
  1033.  for active options, or:
  1034.  
  1035.  % comment
  1036.  
  1037.  for comments in  the configuration file.  In the documentation  we call
  1038.  the first parameter  'option' and the  secondary parameters are  called
  1039.  'parameter'.  For  parameters,  the  following  syntax  is  used in the
  1040.  description:
  1041.  
  1042.  [.....]   this  parameter is mandatory, it  MUST be present and  have a
  1043.            valid value;
  1044.  
  1045.  {.....}   this  parameter  is   optional.  If  it is NOT present,  some
  1046.            default is used;
  1047.  
  1048.  'value'   Values  between  quotes   must  be  coded WITHOUT the  quotes
  1049.            itself UNLESS specified;
  1050.  
  1051.  (*)       If this mark   occurs at the  end of the  options syntax,  it
  1052.            means that this option is  used by other programs in  the MTA
  1053.            package as  well. In  that case  refer to  the bottom  of the
  1054.            description to  see in  which program(s)  the option  is used
  1055.            also;
  1056.  
  1057.  There are  NO restrictions  to the  position you  start the option, nor
  1058.  the  starting  position  of  the  parameters,  but the 'option' and (if
  1059.  present) the  'parameters' have  to be  separated with  at least one or
  1060.  more spaces. You can make any mixture of upper and lower case !
  1061.  
  1062.  Some  of  the  parameters  in  the  MTA.CTL  file can be overruled with
  1063.  command-line switches. A generalized example of MTA.CTL is included  in
  1064.  the release-file. It contains ALL options available in this release.
  1065.  
  1066.  The following chapters will contain the several statements you can  use
  1067.  in MTA.CTL.  In the  documentation, the  statements are  put in logical
  1068.  groups.  These  groups  contain  statements  with  the  same  sort   of
  1069.  functions  or  serve  the  same  group  of  users.  The ACTUAL order of
  1070.  options in the configuration file does not matter at all.
  1071.  
  1072.  
  1073.  3.3.1 Basic statements
  1074.  ───────────────────────────────────────────────────────────────────────
  1075.  The following options are more or less basic options and should be used
  1076.  in any setup. Some of the statements can be left out, because they only
  1077.  add something extra or change the default that MTA itself assumes.
  1078.  
  1079.  ┌─────────────────────────────────────────────────────────────────────┐
  1080.  │ ARCPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1081.  │ UNARCPath   [path] {opt} {DynSwapSiz} {second path}                 │
  1082.  │ PAKPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1083.  │ ZOOPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1084.  │ DWCPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1085.  │ LZHPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1086.  │ LZSPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1087.  │ PKZIPPath   [path] {opt} {DynSwapSiz} {second path}              (*)│
  1088.  │ MDPath      [path] {opt} {DynSwapSiz} {second path}                 │
  1089.  │ PKUNZIPPath [path] {opt} {DynSwapSiz} {second path}              (*)│
  1090.  │ PKUNPAKPath [path] {opt} {DynSwapSiz} {second path}              (*)│
  1091.  │ ARJPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1092.  │ HYPERPath   [path] {opt} {DynSwapSiz} {second path}              (*)│
  1093.  │ PKLITEPath  [path] {opt} {DynSwapSiz} {second path}                 │
  1094.  │ ZIP2EXEPath [path] {opt} {DynSwapSiz} {second path}                 │
  1095.  │ GIFLITEPath [path] {opt} {DynSwapSiz} {second path}                 │
  1096.  │ GIF2JPGPath [path] {opt} {DynSwapSiz} {second path}                 │
  1097.  │ JPG2GIFPath [path] {opt} {DynSwapSiz} {second path}                 │
  1098.  │ GIFTESTPath [path] {opt} {DynSwapSiz} {second path}                 │
  1099.  └─────────────────────────────────────────────────────────────────────┘
  1100.  Usage : These options point to the various archivers you have installed
  1101.          on your system. If you do not include statements for  archivers
  1102.          that ARE installed AND can  be found in the DOS-path,  MTA will
  1103.          search for them itself, so do not be surprised if, for example,
  1104.          you did not include the ZOOPath option but MTA is still able to
  1105.          work with ZOO files. In that case MTA has found ZOO.EXE in  the
  1106.          DOS-path !  If you  have all  archivers in  the DOS-path, it is
  1107.          still advised to include  the options for these  archivers. MTA
  1108.          will be able to pin-point  the archiver directly in this  case,
  1109.          causing a gain  of speed because,  otherwise, MTA will  start a
  1110.          'quest' for the archiver in the DOS-path.
  1111.  
  1112.          [Path]        This parameter must contain the drive,  directory
  1113.                        and filename  of the  archiver in  question.  MTA
  1114.                        will  validate  if  the  program  is at the given
  1115.                        location  and  terminate  with  an  error  if  it
  1116.                        isn't.
  1117.  
  1118.          {opt}         This  parameter  is optional. You  MUST  code  it
  1119.                        when  one  of  the  following  parameters is used
  1120.                        and/or if  you want  to change  the default. This
  1121.                        parameter  must  have  a  value  of either 'Y' or
  1122.                        'N'. The  value will  decide if  THIS archiver is
  1123.                        going to  be included  when you  want to optimize
  1124.                        your archive  on to  the smallest  size. All  the
  1125.                        archive programs that  do COMPRESSION and  have a
  1126.                        value of 'Y'  will be included  if you force  MTA
  1127.                        to  optimize  on  size  (/OOA on the command-line
  1128.                        or OptimizeOnSize  option in  MTA.CTL set).   'N'
  1129.                        will  cause  MTA  to  skip  this  archiver   when
  1130.                        optimize  is  running.  For  some  archivers  the
  1131.                        value is  not important  because they  either can
  1132.                        not COMPRESS (like PKUNZIP) or they have  nothing
  1133.                        to do with  normal file-compression (GIFLITE  and
  1134.                        such), but if  you code one  or more of  the next
  1135.                        parameters you  still must  include a  'Y' or 'N'
  1136.                        ('N' would be obvious.  'Y' is ignored) for  this
  1137.                        parameter;
  1138.  
  1139.          {DynSwapSiz}  This parameter  will instruct MTA if  swapping is
  1140.                        needed  before  the  (de)compression  program  is
  1141.                        actually  called.  In  previous  releases,   this
  1142.                        parameters was set to a fixed value ('SWAP')  but
  1143.                        with  15.01  and  up,  MTA uses DYNAMIC swapping.
  1144.                        You need to supply  the amount of memory  that is
  1145.                        needed to  run the  specific archive  program. In
  1146.                        the  included  example  of  MTA.CTL,  all minimal
  1147.                        values that worked are  included. If you need  at
  1148.                        least  250K  to  run  a specific archive program,
  1149.                        you must  code '256'  (or higher)  over here. For
  1150.                        some programs it is best to swap ALWAYS. In  this
  1151.                        case  a  value  of  '640'  will  do, because that
  1152.                        amount of CONVENTIONAL memory is NEVER  available
  1153.                        when MTA is running,  causing MTA to always  swap
  1154.                        before the archive  program is called.  With this
  1155.                        option you are more or less save when MTA is  run
  1156.                        from  a  secondary  shell.  Programs that need as
  1157.                        much  memory  as  possible  are  GIG2JPG, JPG2GIF
  1158.                        and, in some cases, ARJ.
  1159.  
  1160.          {second path} MTA (from 15.01)  can use two different sets  (or
  1161.                        versions) of a specific archiver. If you use  the
  1162.                        current PKZIP  and a  newer version  (or even  an
  1163.                        alpha or  beta) is  released, you  normally would
  1164.                        like  to  test  this  archiver  before  you start
  1165.                        using it.  For this  situation, you  can use this
  1166.                        parameter. You can rename your new version to  an
  1167.                        alternate name (f.i. P2ZIP.EXE) or you can  place
  1168.                        it in another directory.  When you have done  so,
  1169.                        you  can  include  the  full  path  to  this  new
  1170.                        program in  this parameter.  Now if  you run  MTA
  1171.                        with  the  /ALT  command-line,  MTA  will use the
  1172.                        program that is coded  over and not the  one that
  1173.                        is coded in the [path] parameter. If there is  no
  1174.                        {second  path}  option  included  but you run MTA
  1175.                        with /ALT, the program in [path] is used;
  1176.  
  1177.          Please notice that you must supply the correct programs to  the
  1178.          above  options.  If  you  replace  one  of  the  program's with
  1179.          another one, strange things  (errors) can occur and  data could
  1180.          corrupt.  Supply the following programs to the options:
  1181.  
  1182.          ARCPath             ARC.EXE     or its alias
  1183.          UNARCPath           XARC.EXE    or its alias (see ARC remarks)
  1184.          PAKPath             PAK.EXE     or its alias
  1185.          ZOOPath             ZOO.EXE     or its alias
  1186.          DWCPath             DWC.EXE     or its alias
  1187.          LZHPath             LHARC.EXE   or its alias
  1188.          LZSPath             LARC.EXE    or its alias
  1189.          PKZIPPath           PKZIP.EXE   or its alias
  1190.          MDPath              MDCD.EXE    or its alias
  1191.          PKUNZIPPath         PKUNZIP.EXE or its alias
  1192.          PKUNPAKPath         PKUNPAK.EXE or its alias
  1193.                           or PKXARC.COM  or its alias
  1194.                           or PKXARC.EXE  or its alias
  1195.          ARJPath             ARJ.EXE     or its alias
  1196.          HYPERPath           HYPER.EXE   or its alias
  1197.          ZIP2EXEPath         ZIP2EXE.EXE or its alias
  1198.          GIFLITEPath         GIFLITE.EXE or its alias
  1199.          JPG2GIFPath         JPG2GIF.EXE or its alias
  1200. │                            You need to set DJPEG.EXE if you use
  1201. │                            the StandardJPEG option (see later)
  1202.          GIF2JPGPath         GIF2JPG.EXE or its alias
  1203. │                            You need to set CJPEG.EXE if you use
  1204. │                            the StandardJPEG option (see later)
  1205.          GIFTESTPath         GIFTEST.EXE or its alias
  1206.  
  1207.          Where 'alias'  is the  name you  renamed the  original file to.
  1208.          Please supply  the complete  drive, directory  and filename  to
  1209.          any of the options !  If you leave the drive  and/or directory,
  1210.          MTA will replace it with the CURRENT drive and/or directory.
  1211.  
  1212.          If you don't own one  or more of the (de)compression  programs,
  1213.          leave out the related option, otherwise MTA will abort !
  1214.  
  1215.  Relate: None
  1216.  Dest. : All
  1217.  (*)   : Marked options are also in usage by: MTM
  1218.  
  1219.  
  1220.  ┌─────────────────────────────────────────────────────────────────────┐
  1221.  │ CompressionType [ttt]                                               │
  1222.  └─────────────────────────────────────────────────────────────────────┘
  1223.  Usage : This option sets the normal TARGET archive system. You can,  at
  1224.          any time,  overrule this  target with  another target.  In that
  1225.          case you can supply the correct command-line to do so.
  1226.  
  1227.          [ttt]          This sets the target. You can supply the  values
  1228.                        'ARC',  'PAK',  'ZIP',  'ZOO', 'LZH' (LHarc/LHA),
  1229.                        'LZS' (Larc), 'DWC',  'HYP', 'ARJ', 'MD'  (MDCD),
  1230.                        'PAKSFX',    'ZIPSFX',    'LZHSFX',     'ARJSFX',
  1231.                        'PKLITE',   'UNPKLITE',   'GIFLITE',   'GIF2JPG',
  1232.                        'JPG2GIF', 'GIF', 'SQZ', 'SQZSFX'  and     'OWN'.
  1233.  
  1234.                        Most of  them look  normal. Some  of them  don't.
  1235.                        The  PAKSFX,  ZIPSFX,  LZHSFX,  SQZSFX and ARJSFX
  1236.                        are the same  as PAK, ZIP,  LZH, SQZ and  ARJ but
  1237.                        also  include  the  creation  of an EXE/COM (SFX)
  1238.                        file.   The  PKLITE  can  be  used to convert EXE
  1239.                        files to PKLITE'ed  EXE files, the  UNPKLITE does
  1240.                        the reversed.   The GIFLITE  will convert  normal
  1241.                        GIF files to GIFLITE  GIF's.  The GIF2JPG  can be
  1242.                        used to convert GIF files to JPG files with  JPEG
  1243.                        and JPG2GIF  does the  reversed.   The value  GIF
  1244.                        will  cause  MTA  to  test  all GIF's (normal and
  1245.                        lite)  with  GIFTEST  (no  conversion, other than
  1246.                        removal of obsolete bytes, will be done).
  1247.  
  1248.                        OWN is  used when  you work  with a  special (not
  1249.                        normally supported  compression program,  see the
  1250.                        OWNxxxx options later on).
  1251.  
  1252.                        When set to  PKLITE/UNPKLITE, MTA will  only look
  1253.                        for  COM/EXE  files  that  can  be  converted  to
  1254.                        PKLITE or that are  converted with PKLITE.   When
  1255.                        set to  GIFLITE, GIF2JPG  or GIF,  MTA will  only
  1256.                        look  for  GIF  files,  when  set to JPG2GIF, MTA
  1257.                        will  only  look  for  files  with  the extension
  1258.                        '.JPG'. All other values  will cause MTA to  look
  1259.                        at all known archives.
  1260.  
  1261.          I suggest that you include  the most frequently used target  in
  1262.          MTA.CTL and use command-line switches to work with the  special
  1263.          ones  (so  set  CompressionType  to  ZIP  if ZIP is your normal
  1264.          target and use /PKLITE on  the command-line to let MTA  work on
  1265.          COM/EXE files when needed).
  1266.  
  1267.  Relate: None
  1268.  Dest. : All
  1269.  
  1270.  
  1271.  ┌─────────────────────────────────────────────────────────────────────┐
  1272.  │ LZHVersion [version] {alt version}                                  │
  1273.  │ PAKVersion [version] {alt version}                               (*)│
  1274.  │ ZIPVersion [version] {alt version}                               (*)│
  1275.  └─────────────────────────────────────────────────────────────────────┘
  1276.  Usage : These options set the version number for the various  archives.
  1277.          They are  needed because  the archivers  involved use different
  1278.          command-lines and/or internal  formats for different  versions.
  1279.          MTA can NOT auto-detect  the version-number (f.i. based  on the
  1280.          length of the  archive program) because  these programs can  be
  1281.          converted with PKLITE, DIET,  LZEXE or some other  EXE-compress
  1282.          program. You  MUST set  the manually  and you  MUST set them to
  1283.          the version you actually use !
  1284.  
  1285.          [version]     Must contain   the right  version. 1.10  must  be
  1286.                        translated to 110, 2.0  to 200, 1.13c to  113 and
  1287.                        so on.
  1288.  
  1289.          {alt version} If you use  the /ALT command-line option and  the
  1290.                        archiver  in  question  has  an alternate version
  1291.                        set  with  {second  path}  in the xxxPath option,
  1292.                        you  must  supply  the  version  number  of  this
  1293.                        program if  it is  not the  same as  the one  you
  1294.                        supplied  in  [version].  So  if  you  use   both
  1295.                        PKZIP.EXE (1.10) and  P2ZIP.EXE (2.01), you  must
  1296.                        code 'ZIPVersion 110 201'.  If you do not  supply
  1297.                        {alt version}, it will  be the same as  the value
  1298.                        set for [version] !
  1299.  
  1300.          Some  notes  about  the  various  differences between versions.
  1301.          For LZH, any value under 200  will cause MTA to give a  warning
  1302.          when a  2.xx archive  is found  (it will  skip the conversion).
  1303.          For ZIP, any value under 200  will cause MTA to give a  warning
  1304.          when a ZIP with a 2.xx format is detected (it will not  convert
  1305.          such a file). For PAK, the difference lies between 000  (GSArc)
  1306.          and 100 and  higher (GSArc does  not return an  errorlevel) and
  1307.          100-199 and 200 and higher (other formats in the PAK files).
  1308.  
  1309.          By default, MTA uses the versions 110 for ZIP, 251 for PAK  and
  1310.          213 for LHarc/LHA.
  1311.  
  1312.  Relate: None
  1313.  Dest. : LZH/PAK/ZIP
  1314.  (*)   : Marked options are also in usage by: MTM
  1315.  
  1316.  
  1317. │┌─────────────────────────────────────────────────────────────────────┐
  1318. ││ StandardJPEG                                                        │
  1319. │└─────────────────────────────────────────────────────────────────────┘
  1320. │Usage : When this option is NOT set, MTA will assume the GIF2JPEG and
  1321. │        JPEG2GIF programs from HandMade Software <tm> as the programs
  1322. │        to convert to and from JPEG. If you set this option, MTA will
  1323. │        call the supplied programs without any parameters so you can
  1324. │        use the STANDARD CJPEG and DJPEG programs that come from the
  1325. │        Independent JPEG Group <tm>.
  1326. │
  1327. │Relate: JPG2GIFPath, GIF2JPGPath
  1328. │Dest. : JPG/GIF
  1329.  
  1330.  
  1331.  ┌─────────────────────────────────────────────────────────────────────┐
  1332.  │ ZIPCompression     [parm..parm]                                  (*)│
  1333.  │ ZSFCompression     [parm..parm]                                     │
  1334.  │ DWCCompression     [parm..parm]                                     │
  1335.  │ ARJCompression     [parm..parm]                                     │
  1336.  │ ASFCompression     [parm..parm]                                     │
  1337.  │ ZOOCompression     [parm..parm]                                     │
  1338.  │ LZHCompression     [parm..parm]                                     │
  1339.  │ LSFCompression     [parm..parm]                                     │
  1340.  │ SQZCompression     [parm..parm]                                     │
  1341.  │ SSFCompression     [parm..parm]                                     │
  1342.  │ PKLITECompression  [parm..parm]                                     │
  1343.  │ GIFLITECompression [parm..parm]                                     │
  1344.  │ G2JCompression     [parm..parm]                                     │
  1345.  │ J2GCompression     [parm..parm]                                     │
  1346.  │ GTECompression     [parm..parm]                                     │
  1347.  └─────────────────────────────────────────────────────────────────────┘
  1348.  Usage : These options can be  used to add some extra parameters  to the
  1349.          compression program. Normally MTA uses the standard  parameters
  1350.          for each program  but some of  the programs can  have alternate
  1351.          parameters to set the density of the compression, the usage  of
  1352.          BIOS/Direct screen calls,  the detail of  reporting and so  on.
  1353.          You can add these options yourself (some suggestions are  given
  1354.          below) by  means of  these statements.  Those archive  programs
  1355.          that are NOT included,  don't have any useful  extra parameters
  1356.          that MTA should pass.
  1357.  
  1358.          [parm..parm]  When  you include the  options, you must  set the
  1359.                        parameters you want to  ADD to the ones  that MTA
  1360.                        already  adds.  You  can  code  them  just as you
  1361.                        would do  when you  called the  program from  the
  1362.                        command-line.
  1363.  
  1364.           The following options can  be used to add  (overrule) command-
  1365.           line parameters to the specific program:
  1366.  
  1367.           ZIPCompression     for PKZIP/PKUNZIP
  1368.           ZSFCompression     for ZIP2EXE
  1369.           DWCCompression     for DWC
  1370.           ARJCompression     for ARJ
  1371.           ASFCompression     for ARJ (when creating SFX files)
  1372.           ZOOCompression     for ZOO
  1373.           LZHCompression     for LZH
  1374.           LSFCompression     for LZH (when creating SFX files)
  1375.           SQZCompression     for SQZ
  1376.           SSFCompression     for SQZ (when creating SFX files)
  1377.           PKLITECompression  for PKLITE
  1378.           GIFLITECompression for GIFLITE
  1379.           G2JCompression     for GIF2JPG
  1380.           J2GCompression     for JPG2GIF
  1381.           GTECompression     for GIFTEST
  1382.  
  1383.          For ZIP you could add -es,  -en or -ex to overrule the  default
  1384.          type of  compression, for  ZOO you  could add  the 'h' for high
  1385.          compression (ZOO 2.1x),  for DWC you  could add the  'y' or 'z'
  1386.          for compression  on speed  or size,  of ARJ  the -jm1 parameter
  1387.          would be  nice and  also the  -jo statement  would be nice when
  1388.          you use  ARJ 2.3x+ and want  to convert any backups  inside the
  1389.          archives  as  well.  For  LHarc  the  /o option would force the
  1390.          older (1.13) method and  so we can go  on for a while.  Be sure
  1391.          to  add  only  extra  parameters.  The obvious ones are already
  1392.          passed by MTA  itself. The parameters  for encrypted files  and
  1393.          for special work  directories (and drives)  are also passed  by
  1394.          MTA, depending on other options !
  1395.  
  1396.  Relate: None
  1397.  Dest  : All
  1398.  (*)   : Marked options are also in usage by: MTM
  1399.  
  1400.  
  1401.  ┌─────────────────────────────────────────────────────────────────────┐
  1402.  │ OriginalARJName                                                     │
  1403.  └─────────────────────────────────────────────────────────────────────┘
  1404.  Usage : ARJ  keeps the name  of the archive  (when created) inside  its
  1405.          own  internal  structure.  Normally  you  would  nor  have  any
  1406.          problem with that, but there are users who rename the ARJ to  a
  1407.          name that fits  their own needs  better. When you  include this
  1408.          option in MTA.CTL, MTA will  FIRST rename the file back  to the
  1409.          ORIGINAL name inside  the ARJ-structure BEFORE  conversion will
  1410.          start. This  could be  useful but  please be  warned that  some
  1411.          third  party  archive-conversion  programs  first  create   the
  1412.          archive with a  temporary name before  renaming it to  the name
  1413.          it should  be. In  such case  a file  DSZ1212.ARJ could also be
  1414.          renamed  back  by  MTA  to  ZIPCONV$.$$$  before the conversion
  1415.          starts. In general, when  you receive files from  others, don't
  1416.          use the option, otherwise you could set it.
  1417.  
  1418.  Relate: None
  1419.  Source: ARJ
  1420.  
  1421.  
  1422.  
  1423.  3.3.2 Statements that define the environment that MTA uses
  1424.  ───────────────────────────────────────────────────────────────────────
  1425.  The following statements  all define a  part of the  actual environment
  1426.  that MTA.EXE will use. Included are statements that define the  several
  1427.  directories that MTA can use,  the minimal requirements for memory  and
  1428.  space on the drives, the swapping functions and so on.
  1429.  
  1430.  ┌─────────────────────────────────────────────────────────────────────┐
  1431.  │ TempPath [dir] {bytfree}                                            │
  1432.  └─────────────────────────────────────────────────────────────────────┘
  1433.  Usage : Most decompressors  can   use an  assigned work-directory.   It
  1434.          can be useful  to point this  work-directory to a  virtual disk
  1435.          (a  so called RAM-disk)  or to  the fastest  medium you   have,
  1436.          but,  in  most   cases,   you   must   sure   that  this  drive
  1437.          (directory) will contain  enough space to  hold  the  temporary
  1438.          work  files  for   the  largest   file   to     convert.   Some
  1439.          archivers   also  use   the environment variable TEMP to   look
  1440.          which directory  can   be used  for temporary   work-space.  In
  1441.          MTA you  can (optionally) assign the temporary directory   that
  1442.          will be  passed  to all  archivers  that can work with  such  a
  1443.          directory. In  most cases,   this will  cause the   archiver to
  1444.          use THIS   directory for   work-space and NOT  the one supplied
  1445.          in   the  variable  TEMP  (if  any).   In  doubt,  consult  the
  1446.          documentation of the archiver in question.
  1447.  
  1448.          [dir]         This value must point to a valid  drive/directory
  1449.                        which can  be used  for temporary  work-space. If
  1450.                        no drive  is supplied,  the default  one is used.
  1451.                        Relative  directories  (..\WRKDIR  and  such) are
  1452.                        not  advised  but  can  be  used (the are counted
  1453.                        from the CURRENT directory).
  1454.  
  1455.          {bytfree}     For  most conversions you need at least  a number
  1456.                        of  bytes  free  on  the  assigned work-directory
  1457.                        (drive).  To  make  sure  that  this  amount   is
  1458.                        present  on  that  drive,  you  can,  optionally,
  1459.                        supply the number of  bytes that must be  free as
  1460.                        the third  parameter. If  the number  of bytes on
  1461.                        the drive is LOWER  than the supplied value,  MTA
  1462.                        will not work and abort with an error. If you  do
  1463.                        not supply  a value,  MTA will  look if  at least
  1464.                        256K bytes  is available,  though that  could not
  1465.                        be enough in  some cases. If  you want to  ignore
  1466.                        the test at all, you can supply a value if 0.
  1467.  
  1468.  Relate: None
  1469.  Dest. : All
  1470.  
  1471.  
  1472.  ┌─────────────────────────────────────────────────────────────────────┐
  1473.  │ MTATempPath [dir] {bytfree}                                         │
  1474.  └─────────────────────────────────────────────────────────────────────┘
  1475.  Usage : For every  archive (and  other object)  that MTA will  convert,
  1476.          MTA creates (and later on removes) a temporary directory  UNDER
  1477.          the current directory. If this  is not what you want  (and this
  1478.          is advised), you must supply this option.
  1479.  
  1480.          [dir]         This value must point to a valid  drive/directory
  1481.                        which can be  used for temporary  directories. If
  1482.                        no drive  is supplied,  the default  one is used.
  1483.                        Relative  directories  (..\WRKDIR  and  such) are
  1484.                        not  advised  but  can  be  used (the are counted
  1485.                        from the  CURRENT directory).  In fact,  relative
  1486.                        directories for this option, are useless in  most
  1487.                        cases.
  1488.  
  1489.          {bytfree}     For  most conversions you need at least  a number
  1490.                        of bytes free on the assigned directory  (drive).
  1491.                        To make sure that this amount is present on  that
  1492.                        drive, you can, optionally, supply the number  of
  1493.                        bytes that must be  free as the third  parameter.
  1494.                        If  the  number  of  bytes  on the drive is LOWER
  1495.                        than the  supplied value,  MTA will  not work and
  1496.                        abort  with  an  error.  If  you  do not supply a
  1497.                        value, MTA will  look if at  least 256K bytes  is
  1498.                        available,  though  that  could  not be enough in
  1499.                        some cases.  If you  want to  ignore the  test at
  1500.                        all, you can supply a value if 0.
  1501.  
  1502.          MTA  will  create  temporary  directories UNDER this directory.
  1503.          The name  is 8  bytes long  (and when  you run  as a  second or
  1504.          third TASK, not child,  they also contain the  task-number) and
  1505.          will  represent  the  HEX  value  of  the  time/date  they were
  1506.          created.  When running as  a child of itself (arc-in-arc),  MTA
  1507.          will create temporary directories  with the name '$'  under the
  1508.          original first (8 byte) temporary directory.
  1509.  
  1510.          Some archivers (DWC as the  most important, related to MTA)  do
  1511.          not like  to see  points inside  a directory-name.  Such a name
  1512.          (f.i. DC33ABAF.1) can ONLY be  the LAST tree from the  root. As
  1513.          an  example,  C:\ZIP\DC33ABAF.1  is   allright  with  DWC   but
  1514.          C:\ZIP.ZIP\DC33ABAF.1 is NOT.
  1515.  
  1516.  Relate: ALTMTATempPath
  1517.  Dest. : All
  1518.  
  1519.  
  1520.  ┌─────────────────────────────────────────────────────────────────────┐
  1521.  │ ALTMTATempPath [dir] {bytfree}                                      │
  1522.  └─────────────────────────────────────────────────────────────────────┘
  1523.  Usage : When you have supplied the MTATemppath option, you can also
  1524.          supply this option. The format and usage of this option is
  1525.          the same as for the MTATempPath option.
  1526.  
  1527.          What is the usage of this option ? You can setup the normal
  1528.          MTATEMPPath option to point to a fast drive (like a RAM-disk).
  1529.          Normally a RAM-disk only contains a limited number of bytes
  1530.          and that can be a problem when big archives are converted.
  1531.          If there is not enough free space on the drive that is pointed
  1532.          to by the MTATempPath option, the archive(s) in question will
  1533.          be skipped.
  1534.  
  1535.          If you supply the ALTMTATempPath (along with the MTATEMPPath)
  1536.          you are out of trouble. IN MTATempPath you point to a RAM-disk
  1537.          of average size (or your fastest hard-disk). Most of the small
  1538.          archives will fit in the free space and are converted with a
  1539.          reasonable speed. Now if there are bigger archives that don't
  1540.          fit on that drive, MTA will swap to the drive (and directory)
  1541.          that is pointed to by the ALTMTATempPath option. This can be
  1542.          a normal hard-disk (or a slower one) with more free space. The
  1543.          big archives can still be converted !
  1544.  
  1545.          If an archive won't fit on either of the two drives, MTA will
  1546.          (as before) skip the archive.
  1547.  
  1548.  Relate: MTATempPath
  1549.  Dest. : All
  1550.  
  1551.  
  1552.  ┌─────────────────────────────────────────────────────────────────────┐
  1553. ││ MTAErrorPath [dir] {F|S[count]}                                     │
  1554.  └─────────────────────────────────────────────────────────────────────┘
  1555.  Usage : When  decompression   fails  (memory, corrupted archive and  so
  1556.          on), MTA will  put the original  archive (even though  it could
  1557.          not be OK)  into the temporary  directory that was  assigned to
  1558.          this file (the directory with  the 8-byte (or more) name  under
  1559.          the current directory  OR under the  directory assigned in  the
  1560.          MTATempPath  option   (see  above).   This  will   lead  to   a
  1561.          maintenance  problem  when  much  archives  fail. All corrupted
  1562.          files are moved to different directories and you need tools  to
  1563.          move  (or  delete)  them  all  AND  to  remove  the   temporary
  1564.          directories.  If  you  do  not  want  this maintenance, you can
  1565.          assign a  special directory  where MTA  places such  files. All
  1566.          you have to do, is to include this option in MTA.CTL.
  1567.  
  1568.          [dir]         This value must point to a valid  drive/directory
  1569.                        which  can  be  used  for  files  in error. If no
  1570.                        drive  is  supplied,  the  default  one  is used.
  1571.                        Relative  directories  (..\WRKDIR  and  such) are
  1572.                        not  advised  but  can  be  used (the are counted
  1573.                        from the  CURRENT directory).  In fact,  relative
  1574.                        directories for this option, are useless in  most
  1575.                        cases.
  1576.  
  1577. │        {F|S[count]}  When this parameter is present, MTA will stop the
  1578. │                      conversion when [count] number of files (when you
  1579. │                      use F) or  bytes  (when you  use S) is present in
  1580. │                      [dir]. For  example, F200  will cause MTA to stop
  1581. │                      when there  are  200  or  more files in [dir] and
  1582. │                      S200000 will  cause MTA to stop when all combined
  1583. │                      files in [dir] come to (or exceed) 200.000 bytes.
  1584.  
  1585.  Relate: None
  1586.  Dest. : All
  1587.  
  1588.  
  1589.  ┌─────────────────────────────────────────────────────────────────────┐
  1590.  │ FDUTempPath  [dir]                                                  │
  1591.  │ FDUTrashPath [dir]                                                  │
  1592.  └─────────────────────────────────────────────────────────────────────┘
  1593.  Usage : When you want to  convert whole diskettes to a new  system (use
  1594.          the /D switch,  see later), you  need two special  directories.
  1595.          Without these  directories you  can still  convert archives  on
  1596.          diskette but  you can't  use the  special options  that MTA can
  1597.          offer when  converting diskettes.  There is  a special  chapter
  1598.          about the conversion of diskettes.
  1599.  
  1600.          [dir]         This value must point to a valid  drive/directory
  1601.                        which can be used the  /D option. If no drive  is
  1602.                        supplied,  the  default  one  is  used.  Relative
  1603.                        directories (..\WRKDIR and such) are not  advised
  1604.                        but  can  be  used  (the  are  counted  from  the
  1605.                        CURRENT  directory).   The  directories  must NOT
  1606.                        point  to  the  same  drive  as  you are going to
  1607.                        convert. For a 'mixed' (HDU and FDU) system,  you
  1608.                        must  assign  the  HDU,  for  a  'single'  (FDU 2
  1609.                        times)  system,  you  must  assign a directory on
  1610.                        the other diskette station.
  1611.  
  1612.  Relate: /D option
  1613.  Dest. : All
  1614.  
  1615.  
  1616.  ┌─────────────────────────────────────────────────────────────────────┐
  1617.  │ ITSPath [dir]                                                       │
  1618.  └─────────────────────────────────────────────────────────────────────┘
  1619.  Usage : MTA can be used  in combination with ITS (version 1.06  and all
  1620.          higher versions). When  used in combination  with ITS, MTA  can
  1621.          be stopped like pressing the ESC-key but now without any  human
  1622.          actions involved.  The stopping  of MTA  is ruled  from the ITS
  1623.          task(s) that are running.
  1624.  
  1625.          [dir]         This value must point to a valid  drive/directory
  1626.                        which contains the ITS.SPH  file. If no drive  is
  1627.                        supplied,  the  default  one  is  used.  Relative
  1628.                        directories (..\WRKDIR and such) are not  advised
  1629.                        but  can  be  used  (the  are  counted  from  the
  1630.                        CURRENT directory).
  1631.  
  1632.          MTA MUST find the ITS.SPH file, otherwise MTA will abort,  even
  1633.          when ITS is not  currently in use. If  you don't have (or  use)
  1634.          ITS, you must leave this option OFF.
  1635.  
  1636.  Relate: None
  1637.  Dest. : All
  1638.  
  1639.  
  1640.  ┌─────────────────────────────────────────────────────────────────────┐
  1641.  │ SwapPath [dir]                                                      │
  1642.  └─────────────────────────────────────────────────────────────────────┘
  1643.  Usage : MTA can  (and will)  use a  mechanism to  clear memory when  it
  1644.          needs to. This technique  is called swapping. Swapping  will do
  1645.          the following:
  1646.  
  1647.          - All  data structures  that MTA  uses are  compressed together
  1648.            and written to the swapping device;
  1649.  
  1650.          - All program-coding minus a small piece (the program code  for
  1651.            the swapping itself) will be written to the swapping device;
  1652.  
  1653.          - Memory  is  cleared  an  will  be  rearranged  so it will  be
  1654.            (again) one continuous piece of memory;
  1655.  
  1656.          - The external  program (compressor, decompressor,  exit, virus
  1657.            checker and so on) is called and uses the freed memory;
  1658.  
  1659.          - After termination of the external program, control is  passed
  1660.            to the swapping-code that remained in memory;
  1661.  
  1662.          - The  coding will  (again) rearrange  memory as  it was,  will
  1663.            read   the   program-coding   back   AND   will   read    all
  1664.            data-structures back;
  1665.  
  1666.          - It will clean the swapping device;
  1667.  
  1668.          - It will pass control back to the point where MTA was;
  1669.  
  1670.          With  this  technique,  around  230.000  bytes are removed from
  1671.          memory. These 230.000  were in use  by MTA (non-overlayed)  and
  1672.          there  will  remain  only  a  couple  of bytes for the swapping
  1673.          itself (around 4K bytes).
  1674.  
  1675.          Normally  the  swapping  device  can  be  any  of the following
  1676.          resources:
  1677.  
  1678.          - EMS
  1679.            First   choice,   unless   the   NoEMS   option   (or  /NOEMS
  1680.            command-line parameter)  is supplied  or there  is not enough
  1681.            EMS to contain all data (ca. 230.000 bytes);
  1682.  
  1683.          - XMS
  1684.            Second choice  in SOME  cases. Not  all swapping  routines in
  1685.            MTA  can   support  XMS   yet.  If   the  NoXMS   (or  /NOXMS
  1686.            command-line parameter)  is supplied  or there  is not enough
  1687.            (or no)  XMS to  contain all  data (ca.  230.000 bytes),  MTA
  1688.            will use the next resource;
  1689.  
  1690.          - Disk
  1691.            When there is  not enough (or  no) EMS or  XMS (or the  NoEms
  1692.            and/or NoXMS options are active),  MTA will use disk for  the
  1693.            swapping;
  1694.  
  1695.          When  MTA  is  forced  to  use  disk,  it  will use the current
  1696.          directory for the swap-file that will be created. You can  (and
  1697.          sometimes MUST) overrule this with this option.
  1698.  
  1699.          [dir]         This value must point to a valid  drive/directory
  1700.                        which contains the swapping file. If no drive  is
  1701.                        supplied,  the  default  one  is  used.  Relative
  1702.                        directories (..\WRKDIR and such) are not  advised
  1703.                        but  can  be  used  (the  are  counted  from  the
  1704.                        CURRENT directory).
  1705.  
  1706.          You can also assign a directory  on a RAM-disk when you have  a
  1707.          large one. The only place where MTA disallows disk-swapping  is
  1708.          on  REMOVABLE  drives  (diskettes).  The swap-file (if created)
  1709.          has a  special (unique)  name and  will have  the HIDDEN/SYSTEM
  1710.          attribute. You must NEVER try  to remove such a file  while MTA
  1711.          is still running. It will cause a hangup !
  1712.  
  1713.  Relate: All swapping options
  1714.  Dest. : All
  1715.  
  1716.  
  1717.  ┌─────────────────────────────────────────────────────────────────────┐
  1718.  │ NoEMS                                                               │
  1719.  │ NoXMS                                                               │
  1720.  └─────────────────────────────────────────────────────────────────────┘
  1721.  Usage : When you do not want MTA to use either (or both) EMS or (and)
  1722.          XMS, you can add these option(s) to MTA.CTL. When NoEMS is set
  1723.          and NoXMS isn't and you use QEMM or 386Max (or some program
  1724.          like that), XMS is used. When you set both options, only disk
  1725.          is used. These options are related to the swapping mechanism.
  1726.          This mechanism is the only mechanism in MTA that can make use
  1727.          of EMS/XMS.
  1728.  
  1729.  Relate: All swapping options
  1730.  Dest. : All
  1731.  
  1732.  
  1733.  ┌─────────────────────────────────────────────────────────────────────┐
  1734.  │ MoveToDir [dir]                                                     │
  1735.  └─────────────────────────────────────────────────────────────────────┘
  1736.  Usage :  MTA can,  optionally, move  archives (and  all other converted
  1737.          objects) to another directory  AFTER the conversion. There  are
  1738.          currently 2 different  ways to obtain  this result. One  is the
  1739.          usage of the DefaultPath option (see later), which can be  used
  1740.          by most SysOp's of Bulletin Boards. The other one, the  current
  1741.          option, can be used when  you want to move all  converted files
  1742.          from any directory that you wish to use to a new one.  Normally
  1743.          you will use the  command-line /M to do  so, but if you  always
  1744.          want to have the converted archives on the same place, you  can
  1745.          use the MoveToDir option.
  1746.  
  1747.          [dir]         This value must point to a valid  drive/directory
  1748.                        where  the  files  are  moved  to. If no drive is
  1749.                        supplied,  the  default  one  is  used.  Relative
  1750.                        directories (..\WRKDIR and such) are not  advised
  1751.                        but  can  be  used  (the  are  counted  from  the
  1752.                        CURRENT directory).
  1753.  
  1754.          There  is  one  special  format.  When  combining the /D option
  1755.          (diskette conversion)  with the  MoveToDir (or  the /M command-
  1756.          line parameter), MTA will  convert diskettes from one  diskette
  1757.          to another  one. If  you mix  runs of  MTA to convert diskettes
  1758.          AND to  do normal  conversion, you  can get  problems when this
  1759.          option is put into the MTA.CTL. In such cases it is advised  to
  1760.          use the /M command-line parameter.
  1761.  
  1762.          WARNING: When  you  use  MoveToDir  in  conjunction  with   the
  1763.                   ExitAfterCompression option  you have  to be  aware of
  1764.                   the following extra's:
  1765.  
  1766.                   - When you create an  extra file in the exit  with the
  1767.                     extension  .COM  or  .EXE  which  is  in  the   same
  1768.                     directory   as   the   original   compressed   file,
  1769.                     MoveToDir moves these files also.  When a  name-like
  1770.                     file  already   exist  in   the  MoveToDir    target
  1771.                     directory, MTA  gives you  a warning  and leaves the
  1772.                     file  where  it  was.  This  does  not  go  for  the
  1773.                     original compressed file;
  1774.  
  1775.                   - When  you delete  the original  compression file  in
  1776.                     the  exit,  MTA  will  notice  this and will take no
  1777.                     further actions;
  1778.  
  1779.          When you are running 4Dos <tm> and your original files  contain
  1780.          a  description  in  the  4Dos  description  file,  MTA will use
  1781.          4DOS's MOVE command  to move any  files (if MTA  has detected a
  1782.          full 4DOS environment and the Not4DosAware option is not  set).
  1783.          This  will  cause  any  descriptions  (added  with  4DOS) to be
  1784.          carried along to the new directory.
  1785.  
  1786.  Relate: Not4DosAware, /D command-line parameter
  1787.  Dest. : All
  1788.  
  1789.  
  1790.  ┌─────────────────────────────────────────────────────────────────────┐
  1791.  │ FreeMemory [minfree]                                                │
  1792.  └─────────────────────────────────────────────────────────────────────┘
  1793.  Usage : MTA  uses  memory   very  dynamically.  When  you   convert two
  1794.          different directories you will see that the starting amount  of
  1795.          free memory (displayed by MTA) will never be the same. To  make
  1796.          the  story  short,  almost  every  option  that  can be entered
  1797.          multiple  times  (like  DoNot,  DefaultPath, IncludeFile and so
  1798.          on) will take a  few extra bytes of  memory and all files  that
  1799.          will be  converted (up  to 1000  in one  run) will  also take a
  1800.          dynamic amount of memory. All external calls can be ruled  with
  1801.          a  swap  option  (see  xxxPath,  Virusscanner and all exits) so
  1802.          that is not such  a problem. Also MTA  will take a look  at the
  1803.          memory and  will determine  if it  is possible  to make  itself
  1804.          useful in the presented amount  of bytes. If you still  want to
  1805.          abort  MTA  when  a  specific  number  of  free  bytes  in  NOT
  1806.          available, you can add this option to MTA.CTL.
  1807.  
  1808.          [minfree]     This value must be the number of BYTES (not  KILO
  1809.                        bytes)  that  must  be  free  in order to let MTA
  1810.                        start the conversion.
  1811.  
  1812.          By default MTA will look if  256Kb is free in memory after  all
  1813.          structures are build in memory. You can overrule the test  when
  1814.          you supply 'FreeMemory 0'.
  1815.  
  1816.  Relate: None
  1817.  Dest. : All
  1818.  
  1819.  
  1820.  ┌─────────────────────────────────────────────────────────────────────┐
  1821.  │ Runtime [seconds]                                                   │
  1822.  └─────────────────────────────────────────────────────────────────────┘
  1823.  Usage : MTA can be  interrupted when running attended (by  pressing the
  1824.          ESC key)  but when  you run  UNattended this  can be a problem.
  1825.          When you want to  run MTA for a  certain time (when MTA  is run
  1826.          inside a BBS event for instance), you can supply this option.
  1827.  
  1828.          [seconds]     This value  must be set to the number of  seconds
  1829.                        that MTA must execute.
  1830.  
  1831.          If the time is  over and there are  still files left, MTA  will
  1832.          skip them. To  make sure that  already converted files  are not
  1833.          converted again, it is advised  to either move them to  another
  1834.          directory, use MTA's marking-technique or use the option  where
  1835.          MTA will only convert files that have an earlier date then  the
  1836.          file FILES.MTA (a semaphore file, see later).
  1837.  
  1838.          MTA will always  run somewhat longer  than [seconds]. MTA  will
  1839.          not stop in the middle of a conversion so the one that  started
  1840.          [seconds]-1 will be finished. If  this is a big one,  some time
  1841.          can pass before MTA will terminate.
  1842.  
  1843.  Relate: None
  1844.  Dest. : All
  1845.  
  1846.  
  1847.  ┌─────────────────────────────────────────────────────────────────────┐
  1848.  │ Not4DosAware                                                        │
  1849.  └─────────────────────────────────────────────────────────────────────┘
  1850.  Usage : MTA will do some  internal DOS-calls to see if 4DOS  is present
  1851.          in the machine. If so, MTA will use 4DOS's move on any move  of
  1852.          a file that  will be done  inside MTA. If  there is no  4DOS in
  1853.          usage,  MTA  will  use  its  own  internal  (and quicker) MOVE.
  1854.          4DOS's MOVE is  used to move  any descriptions inside  the file
  1855.          DESCRIPT.ION (a 4DOS internal file which can be present  inside
  1856.          the directory with a HIDDEN attribute).
  1857.  
  1858.          If you don't  use 4DOS descriptions  for your files  and/or you
  1859.          want to use the faster internal  MOVE AND you run 4DOS on  your
  1860.          machine, you can include this option.
  1861.  
  1862.  Relate: MoveToPath (and all internal moves)
  1863.  Dest. : All
  1864.  
  1865.  
  1866.  ┌─────────────────────────────────────────────────────────────────────┐
  1867.  │ VideoMode [mode]                                                    │
  1868.  └─────────────────────────────────────────────────────────────────────┘
  1869.  Usage : MTA can adjust  itself to non-standard text-modes. Some  of the
  1870.          more common examples are 80x43, 132x60 and so on. If you  enter
  1871.          MTA  when  the  screen  is  such  a  mode,  MTA will extend the
  1872.          display in  the actual  number of  lines and,  with modes  that
  1873.          support  more  than   110  characters,  also   the  number   of
  1874.          characters on a line.
  1875.  
  1876.          If you  normally run  in a  normal text-mode  (80x25) but still
  1877.          want to  see MTA  running in  a special  text-mode, you can add
  1878.          this statement to MTA.CTL.
  1879.  
  1880.          [mode]        This  is the  decimal number of  the video   mode
  1881.                        that  MTA  will  try  to  set.  Look  inside your
  1882.                        video-card manual  to see  which mode  you should
  1883.                        use.
  1884.  
  1885.          After MTA  has processed  the MTA.CTL  options, MTA  will reset
  1886.          the video-card to  the supplied mode  (if included in  MTA.CTL)
  1887.          and before termination,  MTA will reset  to the standard  text-
  1888.          mode. If you use an invalid mode, damage to your monitor  could
  1889.          be the case (see video-card manual) or you are not able to  see
  1890.          anything  until  MTA  has  finished  (or  the  machine can even
  1891.          hang).
  1892.  
  1893.          MTA will not alter the video-mode if it can detect that  it  is
  1894.          called under a multi-tasking environment like DesqView <tm>. In
  1895.          these cases the VIDEOMODE option will be obsolete.
  1896.  
  1897.  Relate: None
  1898.  Dest. : All
  1899.  
  1900.  
  1901.  ┌─────────────────────────────────────────────────────────────────────┐
  1902.  │ SubstDrive [drivearray]                                             │
  1903.  └─────────────────────────────────────────────────────────────────────┘
  1904.  Usage : This is a VERY  important option. Most archives include the  so
  1905.          called directory entries. These  are the directories that  were
  1906.          included when the archive was created. If an archive was  made,
  1907.          containing all files (*.*)  from the current directory  and all
  1908.          lower trees AND you supplied the options to include the  actual
  1909.          directories,  given  the  following  structure  (root  is   the
  1910.          current directory):
  1911.  
  1912.          [root, current directory, drive C]
  1913.             CONFIG.SYS
  1914.             [sub-dir HLP]
  1915.             TEST.TST
  1916.                 [sub-dir ZIP]
  1917.                 TEST.TST
  1918.                 [sub-dir ZAP]
  1919.                 TEST.TST
  1920.                    [sub-dir ZA1]
  1921.                    TEST.TST
  1922.                    [sub-dir ZA2]
  1923.                    TEST.TST
  1924.  
  1925.          the  archive  will  contain  one  of the two following formats,
  1926.          either the relative directories:
  1927.  
  1928.          CONFIG.SYS
  1929.          HLP\TEST.TST
  1930.          HLP\ZIP\TEST.TST
  1931.          HLP\ZAP\TEST.TST
  1932.          HLP\ZAP\ZA1\TEST.TST
  1933.          HLP\ZAP\ZA2\TEST.TST
  1934.  
  1935.          or the absolute directories:
  1936.  
  1937.          \CONFIG.SYS
  1938.          \HLP\TEST.TST
  1939.          \HLP\ZIP\TEST.TST
  1940.          \HLP\ZAP\TEST.TST
  1941.          \HLP\ZAP\ZA1\TEST.TST
  1942.          \HLP\ZAP\ZA2\TEST.TST
  1943.  
  1944.          The fact  if there  are ABSOLUTE  or RELATIVE  directories will
  1945.          depend on  the type  of archive  system. Normally  (without the
  1946.          SubstDrive option  set), MTA  will only  convert directories if
  1947.          the  source  archive  system  contains RELATIVE directories AND
  1948.          the target archive system  can contain directory entries.   For
  1949.          some  archivers  you  can  not  be  sure about the fact if they
  1950.          contain ABSOLUTE  or RELATIVE  directories and  some will  ONLY
  1951.          contain  ABSOLUTE  entries.  When  MTA  would  convert  such an
  1952.          archive, it would extract the  archive with all options into  a
  1953.          directory  F:\JUST\AN\EXAMPLE\156DA12F  (just  an  example) but
  1954.          while  decompress  starts,  the  decompress  program  would add
  1955.          files in ABSOLUTE directories, causing NONE of the files to  be
  1956.          added to F:\JUST\AN\EXAMPLE\156DA12F. Files would be stored  in
  1957.          C:\,  C:\HLP\,  C:\HLP\ZIP,  C:\HLP\ZAP,  C:\HLP\ZA1  and   the
  1958.          C:\HLP\ZA2 directory.
  1959.  
  1960.          MTA would be  able to notice  this and could  archive the files
  1961.          from  these  directories  back  into  the new archive (with the
  1962.          delete option) but  there are too  many risks involved.  MTA is
  1963.          created so  UNATTENDED operation  is possible.  To secure this,
  1964.          all warnings  and queries  are suppressed.  MTA would  start to
  1965.          call  the  decompress  program  and  the  first thing that will
  1966.          happen is the overwrite of  CONFIG.SYS on C:\ (all other  files
  1967.          look like if they will  not cause any trouble). When  MTA would
  1968.          start the target-compression program, CONFIG.SYS would then  be
  1969.          archived AND  deleted, leaving  C: without  CONFIG.SYS. Can you
  1970.          imagine what would  happen if files  like IO.SYS and  MSDOS.SYS
  1971.          would be extracted to the root or COMMAND.COM ?
  1972.  
  1973.          Given the  example above,  MTA will  NEVER decompress  archives
  1974.          that could  contain ABSOLUTE  directories unless  you use  some
  1975.          special options. There ARE many archives that have a  structure
  1976.          like this AND you  would still be able  to convert them but  in
  1977.          all cases WITHOUT any risk involved.
  1978.  
  1979.          For this reason, MTA  contains support for SUBSTituted  drives.
  1980.          If you don't know what  the command SUBST means under  DOS, you
  1981.          should read the DOS manual.  In short, SUBST will create  a new
  1982.          drive-letter and the root of  this drive is the same  directory
  1983.          as you supply  to SUBST. So  when you make  a SUBST drive  (G:)
  1984.          from F:\JUST\AN\EXAMPLE\156DA12F (see above), G:\ would be  the
  1985.          same  as   F:\JUST\AN\EXAMPLE\156DA12F  and   all   directories
  1986.          created under G:\ would in fact be created under the  directory
  1987.          F:\JUST\AN\EXAMPLE\156DA12F.  With  this  trick  (which  is   a
  1988.          normal DOS command), you CAN convert archives with  directories
  1989.          that  are  ABSOLUTE  and  you  can  still convert archives with
  1990.          RELATIVE  directories.  If  you  include the SubstDrive option,
  1991.          all  archives  WITH  directories,  no  matter  the  type of the
  1992.          directories, will convert in the  BEST possible way to the  new
  1993.          target (if  the new  target does  not support  directories, MTA
  1994.          can't fix that, but if it does, they will be there).
  1995.  
  1996.          There are some precautions to  take before you start with  this
  1997.          option. First, your DOS must support SUBSTituted drives:
  1998.  
  1999.          - Your DOS  must support SUBSTituted  drives. All DOS  versions
  2000.            from  3.0  and  up  will  contain the support for SUBSTituted
  2001.            drives;
  2002.  
  2003.          - You need the DOS program that can make and delete these  kind
  2004.            of SUBSTituted drives. This  program is called SUBST  (EXE in
  2005.            most cases, sometimes COM).   It would be possible to  have a
  2006.            self-contained  support  in  MTA  but  the  methods to create
  2007.            SUBSTituted drives  vary every  DOS release.  Make sure  that
  2008.            the program  SUBST.EXE or  SUBST.COM is  somewhere inside the
  2009.            DOS-path (MTA will search for the file itself and will  abort
  2010.            if  the  SubstDrive  option  is  set  but  the  SUBST.EXE/COM
  2011.            program isn't found);
  2012.  
  2013.          - You  must alter  the LASTDRIVE  option in  CONFIG.SYS (or set
  2014.            with one of  the QEMM <tm>  utilities) to a  higher value. If
  2015.            your current last drive is F:  and you are going to run  only
  2016.            ONE MTA at a time (it  is possible to run multiple copies  at
  2017.            the same time  under any multi-tasker  like DesqView <tm>  or
  2018.            MS Windows <tm>), you can set it to G:. In fact, you need  as
  2019.            much extra drives as  the number of concurrently  running MTA
  2020.            programs.  If  you  have   a  variable  drive   configuration
  2021.            (sometimes you have a  RAM-disk, sometimes you haven't),  you
  2022.            can also assign a much higher letter. In fact, it is  allowed
  2023.            to use drive Z: for SUBSTituted drives, even if the last  one
  2024.            is F:. In doubt, you  must leave out the LASTDRIVE  option in
  2025.            CONFIG.SYS;
  2026.  
  2027.          - You  must test  the SUBST  program manually  to make  sure is
  2028.            works. Use a directory and  try SUBST on all drives  that are
  2029.            going to use in MTA;
  2030.  
  2031.          If all  points above  are checked,  you can  add the SubstDrive
  2032.          option in MTA.  If you use  the SubstDrive option  with invalid
  2033.          letters things  CAN go  wrong. I  strongly advise  to use drive
  2034.          letters that are NEVER  going to be used  (f.i. Y: and Z:  when
  2035.          running 2  concurrent MTA's  or only  Z: if  you only use one).
  2036.          It IS  possible but  NEVER use  a drive  letter that  is one of
  2037.          your CURRENT drives and certainly  not one of the floppy  drive
  2038.          letters if you want to use the /D option !
  2039.  
  2040.          [drivearray]   You must  supply at  least one  drive-letter but
  2041.                        you  can  supply  op  to  26.  You  must supply a
  2042.                        different  letter  for  each  concurrent MTA that
  2043.                        you  are  going  to  run.  The first MTA (task 1)
  2044.                        uses  the  first  letter,  the  next MTA (task 2)
  2045.                        will  use  the  second  and  so  on  !  With  all
  2046.                        warnings  in  mind,  you  could supply the option
  2047.                        'SubstDrive  Z'  of  one  MTA and 'SubstDrive YZ'
  2048.                        for two concurrently running MTA's;
  2049.  
  2050.          There is  nothing to  worry about  when you  use the SubstDrive
  2051.          option  (unless  you  have  a  very special configuration). MTA
  2052.          will do all the work  for you. MTA will assign  the SUBSTituted
  2053.          drives itself (by calling  SUBST.EXE/COM) and will remove  them
  2054.          again when  conversion is  finished. MTA  will check  the drive
  2055.          letters you supplied  in the SubstDrive  to see if  any of them
  2056.          is a 'real' drive. If this  is the case, MTA will abort.  Under
  2057.          special conditions  this test  may fail  though, so  you should
  2058.          take  all  previous  warnings  in  mind before you start. Don't
  2059.          experiment  with  the  option,  just  do  it  the  way  it   is
  2060.          suggested.
  2061.  
  2062.  Relate: SubstOn, SubstOff
  2063.  Dest. : All
  2064.  
  2065.  
  2066.  ┌─────────────────────────────────────────────────────────────────────┐
  2067.  │ SubstOn [path] {parm}..{parm}                                       │
  2068.  └─────────────────────────────────────────────────────────────────────┘
  2069.  Usage : This  option  can  only   be  used  in  combination  with   the
  2070.          SUBSTDrive  option.   When  used,   the  SubstOff   option   is
  2071.          mandatory.
  2072.  
  2073.          When SubstDrive  is set,  MTA will  use the  following calls to
  2074.          the DOS SUBST.EXE  program to set  the substituted drive  ON or
  2075.          OFF:
  2076.  
  2077.          - On
  2078.            [drive:][dir]\SUBST.EXE [drive_to_page] [dir_to_page_over]
  2079.  
  2080.          - Off
  2081.            [drive:][dir]\SUBST.EXE [drive_to_page] /D
  2082.  
  2083.          Normally  this  will  work  in  the  proper way unless you need
  2084.          another syntax (special DOS-versions) or you even need  another
  2085.          program (networks) to  page (virtual) drives  over directories.
  2086.          For this need,  you can use  the SubstOn and  SubstOff options.
  2087.          With  these  options,  you  can  tell MTA which program(s) with
  2088.          which parameters  are to  be called  to switch  the substituded
  2089.          (paged) drive on (SubstOn) and off (SubstOff):
  2090.  
  2091.          [Path]        This parameter must contain the drive,  directory
  2092.                        and  filename  of  the  program  in question. MTA
  2093.                        will  validate  the working of the program;
  2094.  
  2095.          [parm] {parm} At  this  location   you  can  (must) supply  the
  2096.                        various parameters for  the program. There  are a
  2097.                        few macros  available  that  will  be replaced by
  2098.                        values at run-time. These are:
  2099.  
  2100.                        %DP This  macro will  be replaced  with the drive
  2101.                            letter (without  ':') of  drive that  will be
  2102.                            paged over the temporary directory;
  2103.  
  2104.                        %DF This  macro will  be replaced  with the drive
  2105.                            letter  (WITH  ':')  of  drive  that  will be
  2106.                            paged over the temporary directory;
  2107.  
  2108.                        %PP This macro will be replaced by the  temporary
  2109.                            directory  that  needs  to  be  accessed as a
  2110.                            drive  (normally  a  directory  under the one
  2111.                            you  specified  in  MTATempPath).  This macro
  2112.                            will NOT give a directory with a backslash;
  2113.  
  2114.                        %PF This macro will be replaced by the  temporary
  2115.                            directory  that  needs  to  be  accessed as a
  2116.                            drive  (normally  a  directory  under the one
  2117.                            you  specified  in  MTATempPath).  This macro
  2118.                            WILL give a directory with a backslash;
  2119.  
  2120.                        %NP Same as %PP but without the drive-letter (so
  2121.                            you can create combinations like \\TEM\PAS;
  2122.  
  2123.                        %NF Same as %PF but without the drive-letter (so
  2124.                            you can create combinations like \\TEM\PAS\;
  2125.  
  2126.          Included are  two examples,  one that  will be  the same as MTA
  2127.          uses internally (but now  specified with SubstOn and  SubstOff)
  2128.          and one  for a  network that  needs a  program MAP to subtitute
  2129.          (page the drive).  The first example  is split in  two examples
  2130.          (one with  a DIRECT  call to  SUBST and  one using a batch-file
  2131.          SUBST.BAT):
  2132.  
  2133.          - Using SUBST (THIS IS THE MTA DEFAULT AND NEED NOT BE USED)
  2134.            - Directly:
  2135.              SubstOn  C:\DOS\SUBST.EXE %DF %PP
  2136.              SubstOff C:\DOS\SUBST.EXE %DF /D
  2137.            - Called from a batch-file
  2138.              SubstOn  C:\DOS\COMMAND.COM /C C:\DOS\SUB.BAT %DF %PP
  2139.              SubstOff C:\DOS\COMMAND.COM /C C:\DOS\SUB.BAT %DF /D
  2140.  
  2141.          - Using MAP (only an example, use your own Network-program)
  2142.            SubstOn  C:\NOV\MAP.EXE   %DF=\%NP
  2143.            SubstOff C:\NOV\MAP.EXE R %DF
  2144.  
  2145.  Relate: SubstOff, NoSubstTest
  2146.  Dest. : All
  2147.  
  2148.  
  2149.  ┌─────────────────────────────────────────────────────────────────────┐
  2150.  │ SubstOff [path] {parm}..{parm}                                      │
  2151.  └─────────────────────────────────────────────────────────────────────┘
  2152.  Usage : See SubstOn (SubstOff is used tro switch the substitution off).
  2153.  
  2154.  Relate: SubstOn, NoSubstTest
  2155.  Dest. : All
  2156.  
  2157.  
  2158.  ┌─────────────────────────────────────────────────────────────────────┐
  2159.  │ NoSubstTest                                                         │
  2160.  └─────────────────────────────────────────────────────────────────────┘
  2161.  Usage : When  substituted  drives  will be used by MTA (either by using
  2162.          SUBST or  any  other  kind  of  program  when  the  SubstOn and
  2163.          SubstOff  options  are used), MTA will check (after the 'subst'
  2164.          drive is assigned)  if  this  new drive is not a REAL drive. In
  2165.          certain  configurations  (networks), MTA  will get a REAL drive
  2166.          back  and  will  abort. In  these  cases  this option should be
  2167.          supplied. It  will  bypass  the test for a REAL drive ! If this
  2168.          is used  in  a  normal  (non-network)  DOS environment, you are
  2169.          bypassing  all  security  checks  and strange things can happen
  2170.          if the  SUBST-drive  actually IS a real drive with files. Never
  2171.          use this  option  unless  you know what you are doing AND after
  2172.          you have  made  a  backup  of the files on the drive(s) in that
  2173.          can/will be used.
  2174.  
  2175.  
  2176.  Relate: SubstOn, SubstOff, SubstDrive
  2177.  Dest. : All
  2178.  
  2179.  
  2180.  ┌─────────────────────────────────────────────────────────────────────┐
  2181.  │ ExtendedTesting                                                     │
  2182.  └─────────────────────────────────────────────────────────────────────┘
  2183.  Usage : Some older  decompress programs  do not  return an  errorlevel
  2184.          when something is wrong with the decompress. For example,  some
  2185.          older PAK versions (GSARC) could signal that one or more  files
  2186.          inside the archive  contained a CRC-error  but returned a  zero
  2187.          errorlevel. In these cases  MTA will think that  the decompress
  2188.          is ok, will remove the archive and will compress the  remaining
  2189.          (if any) files to a new archive, causing only a part (or  none)
  2190.          of the original archive to be converted.
  2191.  
  2192.          MTA can make  sure (for 98%)  that the extracted  files are the
  2193.          same as the  ones that are  in the original  source-archive. To
  2194.          add this fail-save mechanism, you must add the  ExtendedTesting
  2195.          option in  MTA.CTL. MTA  will count  the combined  uncompressed
  2196.          bytes that the  archive will show  to the world  and will count
  2197.          these bytes again (bases on  the actual files) after the  files
  2198.          are decompressed. If they  differ, MTA will delete  these files
  2199.          again and will move the original archive to the directory  that
  2200.          contains the  faulty archives.  A warning  is produced  and the
  2201.          next conversion (if any) will start.
  2202.  
  2203.          There are some special archives that can not be tested for  the
  2204.          full 100%. These are:
  2205.  
  2206.          - ARJ  archives with  files that  are compressed  as TEXT-files
  2207.            ARJ can compress  files as TEXT-files  (-t1 parameter on  the
  2208.            ARJ  command-line).  The  filesize  of  such files inside the
  2209.            ARJ-archive  is  showed  as  the  size  WITHOUT any CR/LF and
  2210.            CTRL-Z  (EOF)  markers.  For  instance,  a  text-file  with 2
  2211.            records, each containing 10 bytes, will normally have a  size
  2212.            of (2 x 10) + (2 x 2  (CRLF)) + 1 is 25 bytes. ARJ will  show
  2213.            this file as a file with a size of 20. THIS IS ONLY THE  CASE
  2214.            with files that are compressed with -t1 !  If MTA detects  an
  2215.            ARJ-file  with  such  text-files  inside,  it  will  skip the
  2216.            extended  test  (not  to  worry,  because  ARJ will return an
  2217.            errorlevel when  the files  inside the  original archive  are
  2218.            not OK). In a  discussion with the author  of ARJ I was  told
  2219.            that  this  has  something  to  do  with  the multi- platform
  2220.            (DOS/UNIX and so on) support;
  2221.  
  2222.          - ARJ  and ZOO  archives with  backups inside  Both ZOO and ARJ
  2223.            archives  can  contain  backup  copies,  even multiple backup
  2224.            copies. When you make an archive with the file A.A inside  an
  2225.            a  few  days  later  you  will  do  this  again (with special
  2226.            ZOO/ARJ command-line options), the  first A.A will be  marked
  2227.            as backup  and the  second is  added. This  can go  on for  a
  2228.            large number of times, eventually resulting in archives  that
  2229.            contain (for  instance) 100  A.A files,  1 of  them being the
  2230.            original (the one  added last) and  99 backups.   There is NO
  2231.            direct  support  archival  backups  in  MTA  but  you CAN add
  2232.            options in MTA  to instruct ARJ  (and ZOO) to  extract all of
  2233.            these backups  (with a  rename, done  by the  archive program
  2234.            itself). Because  this is  possible, MTA  will skip  extended
  2235.            testing  for  archives  with  backups  inside.  This  is   no
  2236.            problem. ARJ and  ZOO will both  report errorlevels when  the
  2237.            decompress fails;
  2238.  
  2239.          It is advised to always use ExtendedTesting. The only  drawback
  2240.          is some loss in speed but on hard-disks this will be less  than
  2241.          a second for each file (average).
  2242.  
  2243.  Relate: None
  2244.  Dest. : All
  2245.  
  2246.  
  2247.  ┌─────────────────────────────────────────────────────────────────────┐
  2248.  │ ShareWait [seconds]                                                 │
  2249.  └─────────────────────────────────────────────────────────────────────┘
  2250.  Usage : You can  run multiple copies of  MTA AND it is  possible to run
  2251.          MTA in a second task (along side a BBS). In these cases it  can
  2252.          be possible  that MTA  needs resources  (files) that  the other
  2253.          task  is  using  also.  In  multi-tasking environments you must
  2254.          always load SHARE (see DOS manual) to give support to  programs
  2255.          that would  like to  share resources  (files). If  MTA needs  a
  2256.          resource  that  is  currently  locked  (a  file  that  is being
  2257.          updated by the other task), it will wait until the resource  is
  2258.          free again unless it  takes to long. If  it takes to long,  MTA
  2259.          will abort.
  2260.  
  2261.          MTA will look every 10 seconds to see if a resource if free  to
  2262.          use again  (after the  initial lock).  This process  will go on
  2263.          for 300  seconds (5  minutes) by  default. After  that, no  new
  2264.          cycle will  start, but  MTA will  abort. You  can also stop the
  2265.          cycle by pressing CTRL-E, in which case MTA will abort.
  2266.  
  2267.          [seconds]     By default, MTA will  look every 10 seconds   for
  2268.                        the duration of 300  seconds. You can alter  this
  2269.                        value  to  anything  you  like.  If  you  want to
  2270.                        change it, you  must supply the  ShareWait option
  2271.                        with  that  number  of  seconds. F.i., 'ShareWait
  2272.                        600' will cause MTA to look every 10 seconds  for
  2273.                        the duration of 600 seconds (is 10 minutes).
  2274.  
  2275.          ShareWait is ONLY needed in a multitasking/network  environment
  2276.          and has no meaning  when SHARE is not  loaded. If SHARE is  not
  2277.          loaded and a lock  occurs (multi-tasking without sharing),  MTA
  2278.          will abort directly !
  2279.  
  2280.  Relate: None
  2281.  Dest. : All
  2282.  
  2283.  
  2284.  ┌─────────────────────────────────────────────────────────────────────┐
  2285.  │ AltDisplay                                                          │
  2286.  └─────────────────────────────────────────────────────────────────────┘
  2287.  Usage : When running  in a  normal 80x25  text-screen, MTA can  display
  2288.          two different kind of information windows on the right side  of
  2289.          the  screen.  The  normal  one  contains  a summary of the most
  2290.          important options.  The other  one contains  a dynamic  list of
  2291.          the archives  that still  need to  be converted.  You can  swap
  2292.          between the list with  the 'T' key but  you can also force  MTA
  2293.          to display the dynamic file-list  at startup. In that case  you
  2294.          can  still  swap  screens  with  the  'T'  key, but the dynamic
  2295.          window is the first one to show up when you start MTA.
  2296.  
  2297.          To force  MTA to  start with  the dynamic  file-list, you  must
  2298.          supply the AltDisplay option.  When running in 110+x25+  modes,
  2299.          MTA will always display BOTH windows and the AltDisplay  option
  2300.          will be ignored.
  2301.  
  2302.  Relate: None
  2303.  Dest. : All
  2304.  
  2305.  
  2306.  ┌─────────────────────────────────────────────────────────────────────┐
  2307.  │ WarningTime [cycles]                                             (*)│
  2308.  └─────────────────────────────────────────────────────────────────────┘
  2309.  Usage : MTA will sometimes give a  warning or an error. In this case  a
  2310.          message is displayed and a  'running light' is displayed for  a
  2311.          number of  cycles. You  can stop  the cycles  by hitting ESC or
  2312.          you can wait until it is finished (around 20 seconds).
  2313.  
  2314.          [cycles]      By default, MTA  will use 20 cycles   (equivalent
  2315.                        to 20 seconds). You  can supply any value  from 0
  2316.                        (no cycles) to 65535.
  2317.  
  2318.          If you supply a value of  zero, MTA will also stop making  some
  2319.          noise when errors or warnings are displayed. If you supply  any
  2320.          non-zero value,  MTA will  beep when  an error  or a warning is
  2321.          displayed unless the NoBeep option is active.
  2322.  
  2323.  Relate: NoBeep
  2324.  Dest. : All
  2325.  (*)   : Marked options are also in usage by: MTM
  2326.  
  2327.  
  2328.  ┌─────────────────────────────────────────────────────────────────────┐
  2329.  │ NoBeep                                                              │
  2330.  └─────────────────────────────────────────────────────────────────────┘
  2331.  Usage : By default  MTA will produce a  beep on the PC-speaker  when an
  2332.          error or warning is displayed (or when MTA is finished).  There
  2333.          will be no  sound when WarningTIme  equals a value  of zero but
  2334.          in this case you  will also not see  any messages. If you  want
  2335.          to see  messages but  you dislike  the sound,  you must use the
  2336.          NoBeep option in MTA.CTL.
  2337.  
  2338.  Relate: WarningTime
  2339.  Dest. : All
  2340.  
  2341.  
  2342.  
  2343.  3.3.3 Statements that define the logging
  2344.  ───────────────────────────────────────────────────────────────────────
  2345.  MTA can log almost anything.  The following statements define the  type
  2346.  of logging (if any)  for the several actions  and the actual format  of
  2347.  the logged records.
  2348.  
  2349.  ┌─────────────────────────────────────────────────────────────────────┐
  2350.  │ LogPath [dir]                                                       │
  2351.  │ LogPath [path]                                                      │
  2352.  └─────────────────────────────────────────────────────────────────────┘
  2353.  Usage : MTA can log almost everything. Under normal conditions you  can
  2354.          choose not to log (it will  speed things up a little) but  then
  2355.          you will not be able to create statistical reports and  nothing
  2356.          can be traced back. In a BBS environment you can choose to  log
  2357.          in  the  same  log-file  as  the  one  that is used by your BBS
  2358.          program. In all cases  MTA will try to  open the log in  shared
  2359.          append mode, so current logs will appended to and full  sharing
  2360.          is available. There  are two different  ways you can  setup the
  2361.          logging:
  2362.  
  2363.          [dir]         This value must point to a valid  drive/directory
  2364.                        where logging  will take  place. If  no drive  is
  2365.                        supplied,  the  default  one  is  used.  Relative
  2366.                        directories (..\WRKDIR and such) are not  advised
  2367.                        but  can  be  used  (the  are  counted  from  the
  2368.                        CURRENT directory).   In this  case MTA  will try
  2369.                        to open the file  with the name MTA.LOG  and will
  2370.                        append  to  it  when  it  is present or create it
  2371.                        when it is not (yet) available;
  2372.  
  2373.          [path]        This value must point to a valid  drive/directory
  2374.                        and  filename  of  the  log-file.  If no drive is
  2375.                        supplied,  the  default  one  is  used.  Relative
  2376.                        directories (..\WRKDIR and such) are not  advised
  2377.                        but  can  be  used  (the  are  counted  from  the
  2378.                        CURRENT directory).   In this  case MTA  will try
  2379.                        to open the file with the SUPPLIED name and  will
  2380.                        append  to  it  when  it  is present or create it
  2381.                        when it is not (yet) available;
  2382.  
  2383.          The LogPath option only assigns the actual log-file or (if  not
  2384.          present) will force to 'noLog'. The style of logging that  will
  2385.          be used, will depend on other options. Inside the log-file  you
  2386.          will  see  information,  statistics,  warnings  and errors. The
  2387.          earlier MTA versions contained a ErrorLogPath option. With  the
  2388.          15.01 release (and higher) this option has become obsolete.
  2389.  
  2390.  Relate: LogStyleFormat
  2391.  Dest. : All
  2392.  
  2393.  
  2394.  ┌─────────────────────────────────────────────────────────────────────┐
  2395.  │ LogThreshold [bytes]                                                │
  2396.  └─────────────────────────────────────────────────────────────────────┘
  2397.  Usage : This  option  is used by both MTA and MTL. You can set a number
  2398.          of bytes which  will be  the  threshold for both MTA and MTL to
  2399.          do a special function.
  2400.  
  2401.          [bytes]       This must be a numeric (positive) value that will
  2402.                        be used as the threshold;
  2403.  
  2404.          If the  log-file (as defined on the LOGPATH option) gets bigger
  2405.          than [bytes], MTA  will  terminate  with  an errorlevel that is
  2406.          100 bigger  than  normal. Currently  MTA can terminate with the
  2407.          errorlevels  0 (normal termination), 16 (abnormal termination),
  2408.          100 (normal  termination and LOG-file is bigger than [bytes] or
  2409.          116 (abnormal termination and LOG-file is bigger that [bytes]).
  2410.  
  2411.          MTL will  use  the  LogThreshold  option  to  detect if the log
  2412.          has to  be  compressed  (when MTL  is executed with /BATCH) and
  2413.          will  (or will not)  compress  the  log according to the actual
  2414.          size.
  2415.  
  2416.          MTA can  work  with  errorlevel  for this function, to overcome
  2417.          a useless call to MTL.
  2418.  
  2419.          You can setup  a  batch  where  you can test the errorlevel and
  2420.          call MTL when the errorlevel is 100 or 116.
  2421.  
  2422.  Relate: LogPath and MTL
  2423.  Dest. : All
  2424.  
  2425.  
  2426.  ┌─────────────────────────────────────────────────────────────────────┐
  2427.  │ AVLogPath [dir]                                                     │
  2428.  │ AVLogPath [path]                                                    │
  2429.  └─────────────────────────────────────────────────────────────────────┘
  2430.  Usage : MTA can log AV-codes and names. Under normal conditions you can
  2431.          choose not to log (it will  speed things up a little) but  then
  2432.          you will  not  be  able  to  see which AV-codes belong to which
  2433.          authors. This  log-file  will  contain AV-numbers (from ZIP and
  2434.          ARJ files) and  the  names that belong to that numbers. The log
  2435.          can be a help when you setup the IncludeAVFile option(s). Never
  2436.          point  to  the  same  log as in the LogPath option. The general
  2437.          format  of  the  AV-log  is quite different than the normal log
  2438.          that MTA maintains !
  2439.          There are two different ways you can setup the logging:
  2440.  
  2441.          [dir]         This value must point to a valid  drive/directory
  2442.                        where logging  will take  place. If  no drive  is
  2443.                        supplied,  the  default  one  is  used.  Relative
  2444.                        directories (..\WRKDIR and such) are not  advised
  2445.                        but  can  be  used  (the  are  counted  from  the
  2446.                        CURRENT directory).   In this  case MTA  will try
  2447.                        to open the file  with the name MTA.LOG  and will
  2448.                        append  to  it  when  it  is present or create it
  2449.                        when it is not (yet) available;
  2450.  
  2451.          [path]        This value must point to a valid  drive/directory
  2452.                        and  filename  of  the  log-file.  If no drive is
  2453.                        supplied,  the  default  one  is  used.  Relative
  2454.                        directories (..\WRKDIR and such) are not  advised
  2455.                        but  can  be  used  (the  are  counted  from  the
  2456.                        CURRENT directory).   In this  case MTA  will try
  2457.                        to open the file with the SUPPLIED name and  will
  2458.                        append  to  it  when  it  is present or create it
  2459.                        when it is not (yet) available;
  2460.  
  2461.  Relate: None
  2462.  Dest. : All
  2463.  
  2464.  
  2465.  ┌─────────────────────────────────────────────────────────────────────┐
  2466.  │ NormalPasswordListPath [dir]                                        │
  2467.  │ NormalPasswordListPath [path]                                       │
  2468.  └─────────────────────────────────────────────────────────────────────┘
  2469.  Usage : When  you   create  archives  with passwords  (/OP command-line
  2470.          parameter), MTA will  log these archives  (and passwords) in  a
  2471.          special  log-file.  This  log-file  CAN  be  the  same  as  the
  2472.          log-file that is assigned in the LogPath option or it can be  a
  2473.          different  log.  The  usage  of NormalPasswordListPath is fully
  2474.          optional but if you leave it out and you use passwords for  the
  2475.          target  archives  you  must  remember  the  passwords from your
  2476.          head.
  2477.  
  2478.          [dir]         This value must point to a valid  drive/directory
  2479.                        where logging  will take  place. If  no drive  is
  2480.                        supplied,  the  default  one  is  used.  Relative
  2481.                        directories (..\WRKDIR and such) are not  advised
  2482.                        but  can  be  used  (the  are  counted  from  the
  2483.                        CURRENT directory).   In this  case MTA  will try
  2484.                        to open the file  with the name MTA.NPW  and will
  2485.                        append  to  it  when  it  is present or create it
  2486.                        when it is not (yet) available;
  2487.  
  2488.          [path]        This value must point to a valid  drive/directory
  2489.                        and  filename  of  the  log-file.  If no drive is
  2490.                        supplied,  the  default  one  is  used.  Relative
  2491.                        directories (..\WRKDIR and such) are not  advised
  2492.                        but  can  be  used  (the  are  counted  from  the
  2493.                        CURRENT directory).   In this  case MTA  will try
  2494.                        to open the file with the SUPPLIED name and  will
  2495.                        append  to  it  when  it  is present or create it
  2496.                        when it is not (yet) available;
  2497.  
  2498.  Relate: RandomPasswordListPath, LogStyleFormat
  2499.  Dest. : All
  2500.  
  2501.  
  2502.  ┌─────────────────────────────────────────────────────────────────────┐
  2503.  │ RandomPasswordListPath [dir]                                        │
  2504.  │ RandomPasswordListPath [path]                                       │
  2505.  └─────────────────────────────────────────────────────────────────────┘
  2506.  Usage : MTA has  an option  to assign  RANDOM passwords  to the  target
  2507.          archives (the /OP@ command-line parameter). The files that  are
  2508.          converted and  the passwords  that have  been assigned  to each
  2509.          file MUST be logged. If you  leave out this option and you  use
  2510.          /OP@, MTA will  ENFORCE the logging  in the current  directory,
  2511.          otherwise  it  uses  the  values  that  are  supplied with this
  2512.          option.
  2513.  
  2514.          [dir]         This value must point to a valid  drive/directory
  2515.                        where logging  will take  place. If  no drive  is
  2516.                        supplied,  the  default  one  is  used.  Relative
  2517.                        directories (..\WRKDIR and such) are not  advised
  2518.                        but  can  be  used  (the  are  counted  from  the
  2519.                        CURRENT directory).   In this  case MTA  will try
  2520.                        to open the file  with the name MTA.PWD  and will
  2521.                        append  to  it  when  it  is present or create it
  2522.                        when it is not (yet) available;
  2523.  
  2524.          [path]        This value must point to a valid  drive/directory
  2525.                        and  filename  of  the  log-file.  If no drive is
  2526.                        supplied,  the  default  one  is  used.  Relative
  2527.                        directories (..\WRKDIR and such) are not  advised
  2528.                        but  can  be  used  (the  are  counted  from  the
  2529.                        CURRENT directory).   In this  case MTA  will try
  2530.                        to open the file with the SUPPLIED name and  will
  2531.                        append  to  it  when  it  is present or create it
  2532.                        when it is not (yet) available;
  2533.  
  2534.  Relate: NormalPasswordListPath, LogStyleFormat
  2535.  Dest. : All
  2536.  
  2537.  
  2538.  ┌─────────────────────────────────────────────────────────────────────┐
  2539.  │ LogStyleFormat [styleformat]                                        │
  2540.  └─────────────────────────────────────────────────────────────────────┘
  2541.  Usage : MTA creates  several log-records  under different   conditions.
  2542.          You  can  use  the  standard  log,  but  Sysop's hate all these
  2543.          different log-files  (in general).   MTA can  create customized
  2544.          log-records. With this option,  you can instruct MTA  to create
  2545.          records that  look the  same as  the records  from your  mailer
  2546.          and/or  BBS  program.    The  option  LogStyleFormat  and   the
  2547.          following LogDateFormat/LogTimeFormat  combination can  be used
  2548.          to define  the style  of the  log-records that  MTA will create
  2549.          for  ALL  three   log-files  (LogPath,   NormalPasswordListPath
  2550.          RandomPasswordListPath   log-files).     These   options    are
  2551.          implemented with the idea  that different log-styles only  vary
  2552.          at the start of the records and NOT at the end.
  2553.  
  2554.          The LogStyleFormat  defines the  'structure' of  the log-record
  2555.          header. The format is free but with three special cases:
  2556.  
  2557.          - Spaces must be replaced by underscore characters '_';
  2558.  
  2559.          - The  part  of  the  record  that  contains  the date must  be
  2560.            defined with %D (if a date is wanted);
  2561.  
  2562.          - The  part  of  the  record  that  contains  the time must  be
  2563.            defined with %T (if a time is wanted);
  2564.  
  2565.          - Any  extra CRLF  combinations (to  create a  separation line)
  2566.            must be defined with ^M;
  2567.  
  2568.          [styleformat] This  is  the  actual  string  that  defines  the
  2569.                        format of the log-header. You can use two  macros
  2570.                        inside this string, the %T that will be  replaced
  2571.                        with the time  in the format  as supplied in  the
  2572.                        LogTimeFormat  option   and  %D   that  will   be
  2573.                        replaced with the date in the format as  supplied
  2574.                        in  the  LogDateFormat  option.  You must observe
  2575.                        the 4 rules that are described above;
  2576.  
  2577.          An example  (also read  LogDateFormat and  LogTimeFormat for  a
  2578.          description  of  the  time  and  date  functions).  You want to
  2579.          create records that look like this:
  2580.  
  2581.          +  6 Jan 1990   2:00p   The-start-of-the-log
  2582.  
  2583.          The 'The-start-of-the-log' part  is constructed by  MTA itself,
  2584.          so  you  have  only  to  define  the  header.  This  is done as
  2585.          follows:
  2586.  
  2587.          LogStyleFormat +_%D__%T___       (The '_' replaces the spaces)
  2588.          LogDateFormat  DD_nnn_yyyy
  2589.          LogTimeFormat  HH:mmt
  2590.  
  2591.          %D and %T are  replaced by MTA with  the date and time  formats
  2592.          as  supplied  in   LogDateFormat  and  LogTimeFormat.   MTA.CTL
  2593.          contains  a  number  of  examples  for  the  various BBS/Mailer
  2594.          programs.
  2595.  
  2596.  Relate: LogStartStyleFormat, LogDateFormat, LogTimeFormat
  2597.  Dest. : All
  2598.  
  2599.  
  2600.  ┌─────────────────────────────────────────────────────────────────────┐
  2601.  │ LogStartStyleFormat [styleformat]                                   │
  2602.  └─────────────────────────────────────────────────────────────────────┘
  2603.  Usage : This   is  an   additional    option  you   can use along  with
  2604.          the previous   LogStyleFormat  option.   Some  types   of   log
  2605.          use  a special  format  where   the  actual  date  is put  into
  2606.          an extra record  (with- out any   further meaning than  logging
  2607.          the date).   MTA can create  such a record   for you. MTA  will
  2608.          put   the     record   with   the   format   you   supply    in
  2609.          LogStartStyleFormat into the  log as the first and only  record
  2610.          for THIS run of MTA. If MTA  stops and is started again, a  new
  2611.          record of this type is written.
  2612.  
  2613.          [styleformat] This  is  the  actual  string  that  defines  the
  2614.                        format of  the log-file  start. You  can use  two
  2615.                        macros inside  this string,  the %T  that will be
  2616.                        replaced with the time in the format as  supplied
  2617.                        in the LogTimeFormat option  and %D that will  be
  2618.                        replaced with the date in the format as  supplied
  2619.                        in  the  LogDateFormat  option.  You must observe
  2620.                        the 4 rules that are described above;
  2621.  
  2622.          A type of log with this  format is found in the FrontDoor  <tm>
  2623.          mailer. The  options you  can use  in this  logstyle-format are
  2624.          the same as with the LogStyleFormat option.
  2625.  
  2626.  Relate: LogStyleFormat, LogDateFormat, LogTimeFormat
  2627.  Dest. : All
  2628.  
  2629.  
  2630.  ┌─────────────────────────────────────────────────────────────────────┐
  2631.  │ LogDateFormat [styleformat]                                         │
  2632.  └─────────────────────────────────────────────────────────────────────┘
  2633.  Usage : LogDateFormat is used to define the 'date part' (actually the
  2634.          %D) in the LogStyleFormat option. MTA can is able to replace a
  2635.          number of characters (macros) by parts that make up the date.
  2636.          You can (must) also include special date-separation characters
  2637.          so your newly created date will actually look like a data !
  2638.  
  2639.          [styleformat] This is the actual string that defines the
  2640.                        format of the %D macros, used in the options
  2641.                        LogStyleFormat and LogStartStyleFormat. The
  2642.                        [styleformat] must be coded in the format you
  2643.                        want the date to have. Spaces, used as the
  2644.                        separation between components of the date, must
  2645.                        be coded as spaces (and not as '_' characters).
  2646.                        The following codes can be used:
  2647.  
  2648.                        mm    Month with a (optionally) leading zero
  2649.  
  2650.                        MM    Month  ,,         ,,         ,,   space
  2651.  
  2652.                        dd    Day    ,,         ,,         ,,   zero
  2653.  
  2654.                        DD    Day    ,,         ,,         ,,   space
  2655.  
  2656.                        yy    Year  (format: 92  )
  2657.  
  2658.                        yyyy  Year  (format: 1992)
  2659.  
  2660.                        nnn   Name of the  month (with mixed  case,  like
  2661.                              Jan, Oct  and so  on). The  length of 'nnn'
  2662.                              will  rule  the  length  of  the  name,  so
  2663.                              'nnnn' will be replaced by 'Janu';
  2664.  
  2665.                        NNN   Name of  the month  (UPPER case,  like  JAN
  2666.                              OCT and  so on).  The length  of 'nnn' will
  2667.                              rule  the  length  of  the  name, so 'NNNN'
  2668.                              will be replaced by 'JANU';
  2669.  
  2670.                        www   Name of  the day  (with mixed  case,   like
  2671.                              Fri, Sat  and so  on). The  length of 'www'
  2672.                              will  rule  the  length  of  the  name,  so
  2673.                              'wwww' will be replaced by 'Frid';
  2674.  
  2675.                        WWW   Name of  the month  (UPPER case,  like  FRI
  2676.                              SAT and  so on).  The length  of 'nnn' will
  2677.                              rule  the  length  of  the  name, so 'WWWW'
  2678.                              will be replaced by 'FRID';
  2679.  
  2680.          Some valid examples (notice the separation characters that  are
  2681.          coded between the macros):
  2682.  
  2683.          mm/dd/yy         01/31/90
  2684.          MM-dd-yy          1-31-90
  2685.          dd/mm/yyyy       31/01/1990
  2686.          dd/mm/yyyy       31/01/1990
  2687.          dd NNN yyyy      31 JAN 1990
  2688.          dd nnn yy        31 Jan 1990
  2689.          dd n yyyy        31 J 1990
  2690.          www dd nnn yyyy  Sun 31 Jan 1990
  2691.  
  2692.  Relate: LogStyleFormat, LogStartStyleFormat
  2693.  Dest. : All
  2694.  
  2695.  
  2696.  ┌─────────────────────────────────────────────────────────────────────┐
  2697.  │ LogTimeFormat [styleformat]                                         │
  2698.  └─────────────────────────────────────────────────────────────────────┘
  2699.  Usage : LogTimeFormat is used  to define the 'time part'  (actually the
  2700.          %T) in the LogStyleFormat option. MTA can is able to replace  a
  2701.          number of characters (macros) by  parts that make up the  time.
  2702.          You can (must) also include special time-separation  characters
  2703.          so your newly created time will actually look like a time !
  2704.  
  2705.          [styleformat]  This  is  the  actual  string  that  defines the
  2706.                        format  of  the  %T  macros,  used in the options
  2707.                        LogStyleFormat   and   LogStartStyleFormat.   The
  2708.                        [styleformat]  must  be  coded  in the format you
  2709.                        want  the  time  to  have.  Spaces,  used  as the
  2710.                        separation between components  of the time,  must
  2711.                        be coded as spaces  (and not as '_'  characters).
  2712.                        The following codes can be used:
  2713.  
  2714.                        hh    Hour  with a (optionally) leading zero
  2715.  
  2716.                        HH    Hour   ,,         ,,         ,,   space
  2717.  
  2718.                        mm    Min    ,,         ,,         ,,   zero
  2719.  
  2720.                        MM    Min    ,,         ,,         ,,   space
  2721.  
  2722.                        ss    Sec    ,,         ,,         ,,   zero
  2723.  
  2724.                        SS    Sec    ,,         ,,         ,,   zero
  2725.  
  2726.                        t     will be replaced by 'p' (in pm) or 'a'  (in
  2727.                              am);
  2728.  
  2729.                        T     will be replaced by 'P' (in PM) or 'A'  (in
  2730.                              AM);
  2731.  
  2732.                        e     will be  replaced with 'm'  (in am or   pm)
  2733.                              and must be combined with 'T' or 't';
  2734.  
  2735.                        E     will be  replaced with 'M'  (in AM or   PM)
  2736.                              and must be combined with 'T' or 't';
  2737.  
  2738.                        If   you    leave   out    any    't'/'T'/'e'/'E'
  2739.                        combination, the time will be in 24-hour format.
  2740.  
  2741.          Some  valid  examples  (notice  the  separation characters that
  2742.          are coded between the macros):
  2743.  
  2744.          hh:mm            14:00
  2745.          hh.mmt           02.00p
  2746.          HH:mmte           2:00pm
  2747.          HH:mm:ss         14:00:45
  2748.          hh:mm:ss         14:00:45
  2749.  
  2750.  Relate: LogStyleFormat, LogStartStyleFormat
  2751.  Dest. : All
  2752.  
  2753.  
  2754.  
  2755.  3.3.4 Statements that define the selection of files
  2756.  ───────────────────────────────────────────────────────────────────────
  2757.  There are several options in MTA.CTL that rule the selection of  files.
  2758.  Most of  them are  described in  this chapter.  Those which  have to do
  2759.  with  the  selection  of  files  in  a BBS environment (SysOp's) can be
  2760.  found in the chapter that describes the special BBS parameters.
  2761.  
  2762.  ┌─────────────────────────────────────────────────────────────────────┐
  2763.  │ DefaultPath [dir] {targetdir}                                       │
  2764.  └─────────────────────────────────────────────────────────────────────┘
  2765.  Usage : Without any  special options,  MTA will  start working  in  the
  2766.          current directory. There are several ways to overrule this  (by
  2767.          default in MTA.CTL or temporary  on the command-line).  One  of
  2768.          the  options  that  can  be  used  by both BBS operators and by
  2769.          normal users, is this DefaultPath option. With this option  you
  2770.          force MTA  to convert  files that  are in  the directories that
  2771.          you supply on one or more (up to 255) DefaultPath options.
  2772.  
  2773.          If you  don't do  special actions  AND you  leave the converted
  2774.          files inside  the directories  that you  assign with  the FIRST
  2775.          parameter of this option, MTA will convert them AGAIN when  you
  2776.          start MTA for the second  (and further) time. You can  fix this
  2777.          problem  by  either  marking  the   files  as  done  (see   the
  2778.          MarkString  related  options)  or  by  using  the  OnlyNewFiles
  2779.          option  or  by  moving  them  to  another directory that is not
  2780.          touched by MTA, either automatically or by hand.
  2781.  
  2782.          The selection of  which files inside  these directories are  to
  2783.          be converted is  ruled by the  file-mask(s) that you  supply on
  2784.          the command-line.
  2785.  
  2786.          [dir]         This value must point to a valid  drive/directory
  2787.                        where conversion will take place. If no drive  is
  2788.                        supplied,  the  default  one  is  used.  Relative
  2789.                        directories (..\WRKDIR and such) are not  advised
  2790.                        but  can  be  used  (the  are  counted  from  the
  2791.                        CURRENT directory).
  2792.  
  2793.          {targetdir}   This value  CAN point to a valid  drive/directory
  2794.                        where  files  that  are  converted  in  [dir] are
  2795.                        moved to AFTER the conversion. If no  {targetdir}
  2796.                        is   supplied,   the   files   stay   in   [dir].
  2797.                        Relative  directories  (..\WRKDIR  and  such) are
  2798.                        not  advised  but  can  be  used (the are counted
  2799.                        from the  CURRENT directory).  This parameter  is
  2800.                        optional !!
  2801.  
  2802.          There can  be up  to 255  DefaultPath options.  You can mix the
  2803.          formats (some  of them  can have  a {targetdir},  some of  them
  2804.          don't have this parameter).
  2805.  
  2806.          If  you  use  the  /W  command-line  parameter, the DefaultPath
  2807.          options are ignored ! If  you use the full-screen selection  of
  2808.          files (MTA is  started without any  file-mask), ONLY the  first
  2809.          directory is  converted and  all other  DefaultPath options are
  2810.          ignored !
  2811.  
  2812.  Relate: QBBSPaths, RAPaths, MAXPaths for BBS systems)
  2813.  Dest. : All
  2814.  
  2815.  
  2816.  ┌─────────────────────────────────────────────────────────────────────┐
  2817.  │ DoNot [filemask]                                                    │
  2818.  │ DoNot [path]                                                        │
  2819.  └─────────────────────────────────────────────────────────────────────┘
  2820.  Usage : When   you   use     MTA      unattended   or   you     convert
  2821.          complete directories   (with  f.i.   DefaultPath  options)   it
  2822.          is possible  that   files   are   converted   that   you  don't
  2823.          want to convert.  Examples of  these files  are many  but  most
  2824.          commonly, you can think of files that  came from programs  like
  2825.          XRS (734B0384.TU1 and such) or  files that have a public  usage
  2826.          (like  NODEDIFF.A23 and such).
  2827.  
  2828.          The DoNot option  can be used  to exclude some  files EVEN when
  2829.          they match  the file-mask  selection on  the command-line.  You
  2830.          can use up to 255 of EACH these options (so 255 with [path] AND
  2831.          255 with [filemask]).
  2832.  
  2833.          [path]        This parameter must contain a complete path with
  2834.                        filemask,  so drive, directory and filemask like
  2835.                        in E:\ZIP\*.A??.  Wildcards  in the filemask can
  2836.                        be used (see below);
  2837.  
  2838.          [filemask]    The parameter must  contain a single   file-mask.
  2839.                        You  can  use  the  normal  DOS  wildcards (?,*).
  2840.                        Also  a  special  wildcard  (=)  can be used. '='
  2841.                        will test  for a  shifting match.  So '=WAR' will
  2842.                        match  tradeWAR.zip  and  also  WARning.ARC.  =FZ
  2843.                        will NOT  match with  nodedifF.Zip. In  this case
  2844.                        you  must  use  =F.Z;
  2845.  
  2846.          When using the /D and AllDisketteFiles options together,  files
  2847.          are NEVER excluded.  This is also  the case when  MTA does call
  2848.          to itself (compressed-in-compressed files).
  2849.  
  2850.  Relate: None
  2851.  Dest. : All
  2852.  
  2853.  
  2854.  ┌─────────────────────────────────────────────────────────────────────┐
  2855.  │ SFXFiles                                                            │
  2856.  └─────────────────────────────────────────────────────────────────────┘
  2857.  Usage : With  archive conversion you  have to deal  with so called  SFX
  2858.          files. These  are SelF  eXtracting archives.  In general,  this
  2859.          are normal COM or  EXE files that can  be started as a  program
  2860.          and which task  only is to  decompress all files  that are also
  2861.          inside  this  COM/EXE  file.  SFX  files  are commonly used for
  2862.          distribution of  the archive  programs them  self. It  would be
  2863.          rather  difficult  to  decompress  PKZ110.ZIP  if  this was the
  2864.          first time you got  involved with ZIP, so  such a file will  be
  2865.          distributed as PKZ110.EXE.
  2866.  
  2867.          MTA is able to convert SFX files into a new target system.   To
  2868.          do so, it must be able to recognize such a file as an  archive.
  2869.          These is a lot of coding involved  in MTA to do so and I  won't
  2870.          say that the coding  can trap 100% of  each cases.  Most  other
  2871.          products that  involve archives  will tell  you that  they will
  2872.          recognize SFX  files for  100% but  most of  them will  fail on
  2873.          occasion. A SFX archive contains some executable coding at  the
  2874.          start of the archive.  MTA must be able  (and is) to skip  this
  2875.          coding  and  to  look  for  the  archive  part.  To keep MTA as
  2876.          'generic' as possible, there is no SPECIFIC code for each  type
  2877.          of header.  This would  make maintenance  almost an  impossible
  2878.          job because the headers change with every new version of  every
  2879.          archive that supports  SFX archives. Up  to now, MTA  has never
  2880.          failed its  job BUT  it is  possible that  MTA will recognize a
  2881.          normal  EXE/COM  file  as  being  a  SFX  file.   This is not a
  2882.          problem because the decompression of such a file will fail  and
  2883.          the file will stay as it is.
  2884.  
  2885.          Normally MTA  will NOT  (by default)  convert SFX  archives. If
  2886.          you  supply  this  option,  MTA  will also start converting SFX
  2887.          files  if  they  match  the  file-masks  that you supply on the
  2888.          command-line.
  2889.  
  2890.  Relate: None
  2891.  Dest. : All
  2892.  
  2893.  
  2894.  ┌─────────────────────────────────────────────────────────────────────┐
  2895.  │ MaxGifDim [w] [h] [c]                                               │
  2896.  └─────────────────────────────────────────────────────────────────────┘
  2897.  Usage : This  option  rules   the  selection  of GIF files. It  is only
  2898.          needed when you  run the unregistered  version of GIFLITE  <tm>
  2899.          but  will  also  work  for  GIF  to JPEG conversions. With this
  2900.          option you instruct MTA only to select GIF files that have  the
  2901.          same or a  lower resolution. The  option is ignored  when using
  2902.          GIF as  the compression  type (GIFTEST).  For this  conversion,
  2903.          you   can   add   a   command-line   parameter   for    GIFTEST
  2904.          (GTECompression option) in which  case GIFTEST will reject  all
  2905.          GIF files with dimensions LOWER than a specific one.
  2906.  
  2907.          [w] [h] [c]   With this  3 parameters you  define the   maximum
  2908.                        resolution of  GIF files  what will  be selected.
  2909.                        The values 640  480 256 will  be useful when  you
  2910.                        use the  unregistered version  of GIFLITE,  other
  2911.                        values can be set to narrow the selection.
  2912.  
  2913.          Please notice that  the three parameters  have an OR  relation.
  2914.          If one of them is smaller  than the actual resolution of a  GIF
  2915.          file, the  file is  not selected.  So a  641*479*255 GIF is NOT
  2916.          selected when  the option  is set  to 640  480 256  because the
  2917.          weight (641) is higher than 640.
  2918.  
  2919.  Relate : GIFLite
  2920.  Dest   : GIF types
  2921.  
  2922.  
  2923.  ┌─────────────────────────────────────────────────────────────────────┐
  2924.  │ NoMarked                                                            │
  2925.  └─────────────────────────────────────────────────────────────────────┘
  2926.  Usage : What if you have one or more directories that contain  archives
  2927.          and where you want to  convert ONLY archives that haven't  been
  2928.          converted before ? So a directory contains 20 ZIP archives  and
  2929.          each period, you move 1  or more new archives (ALSO  containing
  2930.          ZIP archives amongst others)  to this directory. You  only want
  2931.          to convert  these 1  or more  archives once,  without having to
  2932.          convert the other 20. This is  a normal problem on a BBS  where
  2933.          various archives are stored  in the upload-space and  the Sysop
  2934.          only wants to convert the newly uploaded archives.
  2935.  
  2936.          There are two  ways to do  it. One is  to use the  OnlyNewFiles
  2937.          option (see  later), but  this is  a very  primitive (but fast)
  2938.          way. The other is to use MTA's Archive Marking System <tm>.
  2939.  
  2940.          When AMS is active, MTA  will convert an archive and  after the
  2941.          conversion is finished,  MTA will add  a special string  at the
  2942.          end of the  archive. This string  is made up  with some special
  2943.          information that will be unique. When MTA runs again, the  file
  2944.          is read and MTA will detect that this string is present. If  it
  2945.          is, MTA will ignore the archive (unless AMS is switched off).
  2946.  
  2947.          If, for  some reason,  you want  to remove  the special string,
  2948.          you can run MTM (a support  utility in this package) to do  so.
  2949.          Also, when  you want  to start  using AMS  and you already have
  2950.          many converted  archives, you  can use  MTM to  add the  string
  2951.          (called the mark-string) to all these files, without having  to
  2952.          convert them.
  2953.  
  2954.          AMS will  be active  when NoMarked  is set  to on.  This option
  2955.          will instruct MTA to look if an archive contains a  mark-string
  2956.          and if so, if  it is the one  that you use on  your system. The
  2957.          mark-string can be created (and made unique) by yourself !
  2958.  
  2959.          All compressors  have been  tested with  this extra information
  2960.          appended and they seem to have no trouble with it. That is  not
  2961.          so strange if you  know that some communication  protocols will
  2962.          append binary  zeroes to  a file,  when transferred,  to fill a
  2963.          complete transfer block.
  2964.  
  2965.          A special word about  the mark-string information. If  everyone
  2966.          should use MTA's default and should download a file,  converted
  2967.          with MTA/NoMarked  and would  like to  convert this  file again
  2968.          with MTA/NoMarked, the file would be ignored. It is advised  to
  2969.          set your  own marker  with the  MarkString option  to something
  2970.          more or  less private.  BBS's could  enter their Node/Net/Point
  2971.          number or the name of the SysOp or something like  Ghostbuster,
  2972.          Snoopy or whatsoever.
  2973.  
  2974.          Another piece of advise. Many  BBS Sysop's like to convert  all
  2975.          files in the  upload-space to see  if there is  a virus inside.
  2976.          MTA is  perfect to  do that  job BUT  you must  be careful with
  2977.          your mark-string. If users can download archives from you  that
  2978.          contain the mark-string, they are able to upload archives  with
  2979.          a virus AND YOUR mark-string also. When this file is placed  in
  2980.          the upload-directory and you use the NoMarked option, MTA  will
  2981.          ignore the  archive because  it already  contains your mark-ID.
  2982.          You can use one of the following scenarios:
  2983.  
  2984.          - Use the  mark-string in the  upload directory conversion  but
  2985.            remove the  string (with  MTM) before  the file  is available
  2986.            for download (when moved to its own directory);
  2987.  
  2988.          - Don't use  the mark-string in  your upload-directory but  use
  2989.            it only in your normal directories;
  2990.  
  2991.          - Don't use the  mark-string in your upload-directory  (run MTM
  2992.            to remove any),  then convert the  file with NoMark  and move
  2993.            it at once to another directory. When MTA is used as an  exit
  2994.            to the  protocol-driver in  your BBS  (you can  use FileDoor,
  2995.            another DISP product, to do so), you can set up marking in  a
  2996.            save way  (convert ALL  archives that  are uploaded  and only
  2997.            convert  archives  that  are   not  marked  in  your   upload
  2998.            directory);
  2999.  
  3000.          NoMarked  has  no  meaning  when  using  /D  with  the AllFiles
  3001.          option.  The mark is not set when the MoveToDir option (/M)  is
  3002.          used.
  3003.  
  3004.  Relate: MoveToDir, /D, MarkString
  3005.  Dest. : All
  3006.  
  3007.  
  3008.  ┌─────────────────────────────────────────────────────────────────────┐
  3009.  │ MarkHeader [markstring]                                          (*)│
  3010.  └─────────────────────────────────────────────────────────────────────┘
  3011.  Usage : The  mark-string that is  used by MTA  to test if  archives are
  3012.          already converted and which is  added to new archives when  the
  3013.          NoMarked option is set, is made up of two parts, the so  called
  3014.          header and  the actual  string). Both  have a  default but when
  3015.          you work with  the NoMarked option,  you should AT  LEAST alter
  3016.          the value of the  string and you COULD  alter the value of  the
  3017.          header also. If you  don't alter one or  both of them, it  will
  3018.          be  possible  that  someone  else  supplies an archive with the
  3019.          same values as  you use (because  they didn't alter  the header
  3020.          also).
  3021.  
  3022.          [markstring]  This must  be a  6 byte  long value  you want  to
  3023.                        assign to the  header. The default  is 3 times  a
  3024.                        binary zero and the  upper-case word MTA. If  you
  3025.                        supply less  than 6  bytes, the  header is filled
  3026.                        up to 6 bytes with spaces.
  3027.  
  3028.          If, for  some reason,  you change  [markstring] after  you have
  3029.          converted one  or more  archives with  the older  [markstring],
  3030.          you must run  MTM to convert  [markstring] to the  new value in
  3031.          those archives that have the old value.
  3032.  
  3033.  Relate: NoMarked, MarkString
  3034.  Dest. : All
  3035.  (*)   : Marked options are also in usage by: MTM
  3036.  
  3037.  
  3038.  ┌─────────────────────────────────────────────────────────────────────┐
  3039.  │ MarkString [string]                                              (*)│
  3040.  └─────────────────────────────────────────────────────────────────────┘
  3041.  Usage : The  mark-string that is  used by MTA  to test if  archives are
  3042.          already converted and which is  added to new archives when  the
  3043.          NoMarked option is set, is made up of two parts, the so  called
  3044.          header and  the actual  string). Both  have a  default but when
  3045.          you work with  the NoMarked option,  you should AT  LEAST alter
  3046.          the value of the  string and you COULD  alter the value of  the
  3047.          header also. If you  don't alter one or  both of them, it  will
  3048.          be  possible  that  someone  else  supplies an archive with the
  3049.          same values as  you use (because  they didn't alter  the header
  3050.          also).
  3051.  
  3052.          [markstring]  This  must be a  14 byte long  value you want  to
  3053.                        assign to the string.  The default has the  value
  3054.                        'MTAYour ID here !'.  If you supply less  than 14
  3055.                        bytes, the string is  filled up to 14  bytes with
  3056.                        spaces.
  3057.  
  3058.          If, for  some reason,  you change  [markstring] after  you have
  3059.          converted one  or more  archives with  the older  [markstring],
  3060.          you must run  MTM to convert  [markstring] to the  new value in
  3061.          those archives that have the old value.
  3062.  
  3063.  Relate: NoMarked, MarkString
  3064.  Dest. : All
  3065.  (*)   : Marked options are also in usage by: MTM
  3066.  
  3067.  
  3068.  ┌─────────────────────────────────────────────────────────────────────┐
  3069.  │ UnMark                                                              │
  3070.  └─────────────────────────────────────────────────────────────────────┘
  3071.  Usage : Unmark  overrules  the   NoMark  option and should not be  used
  3072.          together with it. The option  is there for those special  cases
  3073.          where  an  archiver  is  not  able  to decompress a file with a
  3074.          mark-string at  the end.  The earlier  (older) LHA.EXE programs
  3075.          (2.0x series, the 2.1x series  work ok), would fail with  a CRC
  3076.          check when the  file was longer  than the length  calculated by
  3077.          LHA itself. This foolish option  is removed from LHA and  there
  3078.          is no current usage for the option.
  3079.  
  3080.  Relate: NoMarked, MarkHeader
  3081.  Dest. : All
  3082.  
  3083.  
  3084.  ┌─────────────────────────────────────────────────────────────────────┐
  3085.  │ ExcludeFriendlyMark [markmask]                                      │
  3086.  └─────────────────────────────────────────────────────────────────────┘
  3087.  Usage : When your receive  files from a known BBS and that BBS has done
  3088.          everthing  to  the archive  that you would normally do yourself
  3089.          (the correct  virus-scanners,  the correct target format and so
  3090.          on), you could  select to skip conversion of such files because
  3091.          you are doing the same as the BBS has already done for you !
  3092.  
  3093.          With  the  ExcludeFriendlyMark (up  to  10 of these options are
  3094.          allowed), you can instruct MTA which files (in combination with
  3095.          those files that  already  carry your own mark) can be skipped.
  3096.          The only thing  that you must know, is the mark-string that the
  3097.          BBS uses (the BBS must use marking to make this option work).
  3098.  
  3099.          [markmask]    This  must be a  20 byte long  value you want  to
  3100.                        use as the mask. Depending on the values that the
  3101.                        BBS uses  (there  can be non-printable characters
  3102.                        in use, when  the  MTA-default  is used), you can
  3103.                        use the  '?'  wildcard on one or more placed. You
  3104.                        can NOT  include  spaces in the mask ! Spaces can
  3105.                        be replaced with a wildcard ('?');
  3106.  
  3107.          An example:
  3108.  
  3109.          ExcludeFriendlyMark ??????Rob?van.Hoeven
  3110.  
  3111.          The first  6 characters  are  masked  because  they are the MTA
  3112.          default X'00'  (6 times)  and  not  printable  characters.  The
  3113.          space  between  'Rob' and 'van.Hoeven'  is  also masked because
  3114.          there are no spaces allowed in the ExcludeFriendlyMark option.
  3115.  
  3116.  Relate: NoMarked, MarkHeader
  3117.  Dest. : All
  3118.  
  3119.  
  3120.  ┌─────────────────────────────────────────────────────────────────────┐
  3121.  │ OnlyNewFiles                                                        │
  3122.  └─────────────────────────────────────────────────────────────────────┘
  3123.  Usage : This  option  works   something  different  than  the  NoMarked
  3124.          option.  When set,  MTA will look for  a file FILES.MTA in  the
  3125.          directory where  the source-archives  are.   MTA will  read the
  3126.          date/time of this file and  EVERY file with a date/time  HIGHER
  3127.          than the date/time of FILES.MTA will be converted.  At the  end
  3128.          of the conversion, MTA will  set the dat/time of the  FILES.MTA
  3129.          to the current date and time.
  3130.  
  3131.          If no   FILES.MTA is   present, MTA   will assume   0 for  both
  3132.          the date   and  time   (resulting  in   a  conversion   of  ALL
  3133.          selected files)  and will  create the  file when  conversion is
  3134.          done.
  3135.  
  3136.  Relate: None
  3137.  Dest. : All
  3138.  
  3139.  ┌─────────────────────────────────────────────────────────────────────┐
  3140.  │ DelOldFiles [mm-yyyy] {action}                                      │
  3141.  │ DelOldFiles [-days]   {action}                                      │
  3142.  └─────────────────────────────────────────────────────────────────────┘
  3143.  Usage : MTA   is able to   do some maintenance   for you also.    Users
  3144.          with big  libraries  of   archives  would  like  to  clean some
  3145.          of the older  ones, once in  a  while.  Also, BBS SysOp's  like
  3146.          to  remove  uploaded  files   when  they   are  too   old. Most
  3147.          protocol drivers (also FileDoor) have   such options but   most
  3148.          of them  only look at the file date (FileDoor looks inside  the
  3149.          archive). With  MTA you can  assign a  file date  that  depends
  3150.          on the files inside the  archives  (see  later).  If  you   did
  3151.          so, you can  use this option  to clean your  library from older
  3152.          files.
  3153.  
  3154.          [mm-yyyy]     Is the  month (2 bytes,  use leading zeros)   and
  3155.                        yyyy is the year of the oldest files you want  to
  3156.                        KEEP in your library.  If the file date  is lower
  3157.                        than [mm-yyyy], MTA  will do something  with that
  3158.                        file,  depending  on  the  presence of the second
  3159.                        parameter and the DelOldPath option;
  3160.  
  3161.          [-days]       You can also use this syntax as a replacement for
  3162.                        [mm-yyyy]. In this case, you supply the number of
  3163.                        days  that  must  be  subtracted from the current
  3164.                        date. This new date  will now be the marking-line
  3165.                        and  older  files  are  considered 'too old'. You
  3166.                        must  supply  the minus sign and a number of days
  3167.                        (up to 32767)  that  must  be subtracted from the
  3168.                        current date.
  3169.  
  3170.          {action}      {action} can have the following values:
  3171.  
  3172.                        NONE  : MTA  will sound  the bell  (if NoBeep  is
  3173.                                not set and WarningTime is not zero)  and
  3174.                                will   give   a   warning.   The   actual
  3175.                                manipulation of the file will follow;
  3176.  
  3177.                        NOMSG : MTA will  not sound  the bell,  nor  will
  3178.                                there be any message;
  3179.  
  3180.                        ASK   : MTA will  ask the user if this file  must
  3181.                                be manipulated  or not.  The file  IS too
  3182.                                old  (otherwise  no  questions  will   be
  3183.                                asked)  but  it  allows  you  to manually
  3184.                                exclude  some  of  the  files  from   the
  3185.                                manipulation  that  will  follow. You can
  3186.                                answer 'Y'  or 'N'.  This parameter  must
  3187.                                not  be  used  when  you  want to run MTA
  3188.                                unattended.
  3189.  
  3190.          If the DelOldPath option is NOT  set and the file IS marked  as
  3191.          too old (either direct or  after a positive reply when  you use
  3192.          the  ASK  parameter),  MTA  will   DELETE  the  file.  If   the
  3193.          DelOldPath option IS set and the file IS marked, MTA will  MOVE
  3194.          the file to the directory assigned in the DelOldPath option.
  3195.  
  3196.  Relate: DelOldPath
  3197.  Dest. : All
  3198.  
  3199.  
  3200.  ┌─────────────────────────────────────────────────────────────────────┐
  3201.  │ DelOldPath [dir]                                                    │
  3202.  └─────────────────────────────────────────────────────────────────────┘
  3203.  Usage : If DelOldFiles  is set  and a  file is  marked as too old,  MTA
  3204.          will delete the file, unless you supply the DelOldPath  option.
  3205.          If this  option is  supplied, MTA  will MOVE  (not delete)  the
  3206.          file to the assigned directory.
  3207.  
  3208.          [dir]         This value must point to a valid  drive/directory
  3209.                        where the files  are moved to  when they are  too
  3210.                        old.  If  no drive is  supplied, the default  one
  3211.                        is  used.   Relative  directories  (..\WRKDIR and
  3212.                        such) are not  advised but can  be used (the  are
  3213.                        counted from the CURRENT directory).
  3214.  
  3215.  Relate: DelOldFiles
  3216.  Dest. : All
  3217.  
  3218.  
  3219.  ┌─────────────────────────────────────────────────────────────────────┐
  3220.  │ SkipNewFiles [days]                                                 │
  3221.  └─────────────────────────────────────────────────────────────────────┘
  3222.  Usage : Where DelOldFiles will do something for files that are too old,
  3223.          this option can  be  used  to  skip  files  that are too new to
  3224.          convert.
  3225.  
  3226.          [days]        This value must be set to the number of days that
  3227.                        an archive can not be converted by MTA. Any value
  3228.                        between 1 and 65535 is valid.
  3229.  
  3230.          MTA will not  convert the files if the file-date/time is higher
  3231.          than [currentdate]-[days]. This  can  be useful  when you don't
  3232.          want to change archives for a certain number of days.
  3233.  
  3234.  Relate: None
  3235.  Dest. : All
  3236.  
  3237.  
  3238.  3.3.5 Statements that define the resulting files
  3239.  ───────────────────────────────────────────────────────────────────────
  3240.  MTA  includes  a  number  of  options  that  will  rule  the  resulting
  3241.  archives.   These include  optimizing the  files, the  comments to add,
  3242.  the files to add and remove from the archive and so on.
  3243.  
  3244.  ┌─────────────────────────────────────────────────────────────────────┐
  3245.  │ ExcludeFile [filemask]                                           (*)│
  3246.  │ ExcludeFile [filemask] {SUB}                                        │
  3247.  └─────────────────────────────────────────────────────────────────────┘
  3248.  Usage : Today there can be no archive that does not include some  files
  3249.          that have no relation with the actual archive but which  is/are
  3250.          added as some sort of advertisement. Every BBS adds, at  least,
  3251.          a comment in the  archive, so you can  read over and over  from
  3252.          which BBS the file came but there are also BBS Sysop's who  add
  3253.          files  to  the  archive  with  the same (or other) information.
  3254.          When I  had to  choose, I  would like  to see  NONE of the both
  3255.          ways (all the extra  bytes will cause longer  connections, thus
  3256.          costing money) but if  I had to choose  between one of them,  I
  3257.          would rather like to see included files than archive  comments.
  3258.          The included files are  compressed (thus costing less  transfer
  3259.          time)  but  the  comments  are  not  !  I wait for the day that
  3260.          SysOp's start to add  GIF's (640*480*256 or higher)  with their
  3261.          own  pictures.  In  that  case  we  all  can  have  fun when we
  3262.          download  an  archive  with  2   Kb  programs  and  300Kb   GIF
  3263.          advertisements !
  3264.  
  3265.          Normally, when you  obtain archives with  added advertisements,
  3266.          you would  like to  remove them  as soon  as possible. There is
  3267.          one thing positive about it, MOST SysOp's use the same name  of
  3268.          the  included  file(s)  over  and  over.  MTA  can remove these
  3269.          files, based  on their  name, AFTER  the decompression  AND the
  3270.          check for any virus. So  these files ARE included in  the check
  3271.          for a virus.
  3272.  
  3273.          [filemask]    The parameter must  contain a single   file-mask.
  3274.                        You  can  use  the  normal  DOS  wildcards (?,*).
  3275.                        Also  a  special  wildcard  (=)  can be used. '='
  3276.                        will test  for a  shifting match.  So '=WAR' will
  3277.                        match  tradeWAR.zip  and  also  WARning.ARC.  =FZ
  3278.                        will NOT  match with  nodedifF.Zip. In  this case
  3279.                        you  must  use  =F.Z.   You  must  only include a
  3280.                        file-mask and not a directory and/or drive;
  3281.  
  3282.          {SUB}         If you code  SUB  on  the ExcludeFile option, MTA
  3283.                        will also look  into all sub-directories that are
  3284.                        created by the  extraction. If  a  match is found
  3285.                        in a sub-directory, MTA  will also remove it from
  3286.                        the archive. If  the  parameter is NOT coded, MTA
  3287.                        will only  look  in the relative 'root' directory
  3288.                        of the archive.
  3289.  
  3290.          The  usage  of  the  '='  wildcard  can be handy when the SysOp
  3291.          alters the name of his/her  include file now and then.  In most
  3292.          cases you will see a range like this:
  3293.  
  3294.          JOHNDOE.ADD $JOHNDOE.ADD
  3295.          JOHNDOE$.ADD JOHNDOE.$$$
  3296.  
  3297.          It is a real  pain in the neck  and I can't see  the reason for
  3298.          doing so, but with =JOHNDOE for [filemask], you get rid of  all
  3299.          these files. Don't  use README or  READ.ME. If some  SysOp adds
  3300.          files like this as  an advertisement, they should  think twice.
  3301.          Most of the time, these files contain important info about  the
  3302.          package you have just obtained.
  3303.  
  3304.          You can use up to 255 (!) ExcludeFile statements in MTA.CTL.
  3305.  
  3306.  Relate: IncludeFile
  3307.  Dest. : All
  3308.  (*)   : Marked options are also in usage by: MTM
  3309.  
  3310. ExcludeFiles [mask] {SUB}
  3311.  
  3312. When the new SUB option is coded, MTA will also test if this mask will
  3313. match files in all SUB-directories that are extracted. If nothing is
  3314. supplied, only the root directory of the extracted files is tested;
  3315.  
  3316.  
  3317.  ┌─────────────────────────────────────────────────────────────────────┐
  3318.  │ IncludeFile [path] {newname} {CF$}                               (*)│
  3319.  └─────────────────────────────────────────────────────────────────────┘
  3320.  Usage : See  the  discussion   on  ExcludeFile. This option can do  the
  3321.          reversed. Where  ExcludeFile removes  any advertisement  files,
  3322.          IncludeFile can add your own advertisement !
  3323.  
  3324.          [path]        This value must point to a valid  drive/directory
  3325.                        and filename of the file to include. If no  drive
  3326.                        is supplied, the default  one is used.   Relative
  3327.                        directories (..\WRKDIR and such) are not  advised
  3328.                        but  can  be  used  (the  are  counted  from  the
  3329.                        CURRENT directory);
  3330.  
  3331.          {newname}     This optional  parameter can be  used to   change
  3332.                        the name of the  file assigned with [path]  as it
  3333.                        appears in  the archive.  For example,  if [path]
  3334.                        is   C:\COMMON\MYFILES.ASC   and   {newname}   is
  3335.                        JDOEBBS.ADD,  the  file  inside  the archive will
  3336.                        actually be called JDOEBBS.ADD. If you don't  use
  3337.                        the {newname} parameter, the file will be  called
  3338.                        MYFILES.ASC;
  3339.  
  3340.          {CF$}         This parameter is optional. When you use it,  the
  3341.                        {newname}  parameter  is  mandatory because {CF$}
  3342.                        MUST  be  the  third  parameter  !  When you code
  3343.                        CF$,  you  are  telling  MTA  that  the  file you
  3344.                        include is  in fact  an archive.   In this  case,
  3345.                        MTA will  convert the  included file  to the same
  3346.                        system as the target system for the archive.
  3347.  
  3348.          There can be up to 255 IncludeFile options in the MTA.CTL.  All
  3349.          files will be included  in EVERY converted extension.  When you
  3350.          leave  out  the  option,  nothing  is  included. I hope that no
  3351.          SysOp will use ALL 255 options for advertisement files.
  3352.  
  3353.  Relate: ExcludeFile
  3354.  Dest. : All
  3355.  (*)   : Marked options are also in usage by: MTM
  3356.  
  3357.  
  3358.  ┌─────────────────────────────────────────────────────────────────────┐
  3359.  │ TouchLow                                                            │
  3360.  └─────────────────────────────────────────────────────────────────────┘
  3361.  Usage : This parameter is optional and controls MTA's touching  system.
  3362.          When used, MTA touches (resets the compressed file's  time/date
  3363.          stamp) to  the lowest  date of  any file  inside the compressed
  3364.          file.  All  files  that  match  any supplied ExcludeFile option
  3365.          (see before)  are NOT  looked at.  As an  example, the  archive
  3366.          contains:
  3367.  
  3368.          A.A           12/31/91
  3369.          B.B           11/18/91
  3370.          C.C           01/01/92
  3371.          JOHNDOE.ADD   01/01/91
  3372.  
  3373.          JOHNDOE.ADD is not looked at  because it matches one (or  more)
  3374.          of  the  ExcludeFile  options.  With  TouchLow set, the archive
  3375.          will get the  date 11/18/91 (JOHNDOE.ADD  has a lower  date but
  3376.          is not looked at).
  3377.  
  3378.          When TouchLow is set, TouchCur and  TouchHig  can  not be used.
  3379.          When neither TouchLow  nor  TouchCur  nor TouchHig are set, MTA
  3380.          will retain the original file date/time;
  3381.  
  3382.  Relate: TouchCur, TouchHig, ChildTouch
  3383.  Dest. : All
  3384.  
  3385.  
  3386.  ┌─────────────────────────────────────────────────────────────────────┐
  3387.  │ TouchHig                                                            │
  3388.  └─────────────────────────────────────────────────────────────────────┘
  3389.  Usage : This parameter is optional and controls MTA's touching  system.
  3390.          When used, MTA touches (resets the compressed file's  time/date
  3391.          stamp) to the  highest date of  any file inside  the compressed
  3392.          file.  All  files  that  match  any supplied ExcludeFile option
  3393.          (see before)  are NOT  looked at.  As an  example, the  archive
  3394.          contains:
  3395.  
  3396.          A.A           12/31/91
  3397.          B.B           11/18/91
  3398.          C.C           01/01/92
  3399.          JOHNDOE.ADD   02/01/92
  3400.  
  3401.          JOHNDOE.ADD is not looked at  because it matches one (or  more)
  3402.          of  the  ExcludeFile  options.  With  TouchHig set, the archive
  3403.          will get the date 01/01/92  (JOHNDOE.ADD has a higher date  but
  3404.          is not looked at).
  3405.  
  3406.          When TouchHig is set, TouchCur and  TouchLow  can  not be used.
  3407.          When neither TouchLow  nor  TouchCur  nor TouchHig are set, MTA
  3408.          will retain the original file date/time;
  3409.  
  3410.  Relate: TouchCur, TouchLow, ChildTouch
  3411.  Dest. : All
  3412.  
  3413.  
  3414.  ┌─────────────────────────────────────────────────────────────────────┐
  3415.  │ TouchCur                                                            │
  3416.  │ TouchCur [+days]                                                    │
  3417.  └─────────────────────────────────────────────────────────────────────┘
  3418.  Usage : This parameter is optional and controls MTA's touching  system.
  3419.          When used, MTA touches (resets the compressed file's  time/date
  3420.          stamp) to the current date.
  3421.  
  3422.          When TouchCur is set, TouchHig and  TouchLow  can  not be used.
  3423.          When neither TouchLow  nor  TouchCur  nor TouchHig are set, MTA
  3424.          will retain the original file date/time.
  3425.  
  3426.          A special format  is the usage of [+days]. If this parameter is
  3427.          present, MTA will  add  the  number of days that is supplied in
  3428.          this parameter to the  current  date and will touch all archives
  3429.          with that new date (comes in  handy when using a BBS and giving
  3430.          the new uploads a new date in the future).
  3431.  
  3432.          [+days]       This  value  must  be  set to a plus sign and the
  3433.                        number of days (up to 365)  to add to the current
  3434.                        date;
  3435.  
  3436.  Relate: TouchLow, TouchHig, ChildTouch
  3437.  Dest. : All
  3438.  
  3439.  
  3440.  ┌─────────────────────────────────────────────────────────────────────┐
  3441.  │ ChildTouch [type]                                                   │
  3442.  └─────────────────────────────────────────────────────────────────────┘
  3443.  Usage : Normally, MTA will use  the same type of touching for  archives
  3444.          inside  archives  (nested  arc-in-arc  files)  as  for the main
  3445.          archive. When this is  not what you want,  you can make use  of
  3446.          this ChildTouch  option to  overrule the  touching with another
  3447.          method for nested archives.
  3448.  
  3449.          [type]        You must either  supply HIGH, LOW, CUR or   FILE.
  3450.                        When HIGH is used,  touching on the highest  date
  3451.                        will  occur  for  nexted  archives,  LOW  for the
  3452.                        lowest date,  CUR for  the current  date and FILE
  3453.                        will cause the original  date to be retained  for
  3454.                        these nested archives.
  3455.  
  3456.          As an example, you can  touch all archives on current  date (so
  3457.          they will show as  new files on a  BBS) but it is  logical that
  3458.          this is not desired for archives inside archives. These  nested
  3459.          archives can be touched in another way if you include this  op-
  3460.          tion;
  3461.  
  3462.  Relate: TouchLow, TouchHig, TouchCur
  3463.  
  3464.  
  3465.  ┌─────────────────────────────────────────────────────────────────────┐
  3466.  │ IgnoreTimeComponent                                              (*)│
  3467.  └─────────────────────────────────────────────────────────────────────┘
  3468.  Usage : This  option  belongs   to  the previous TouchHig and  TouchLow
  3469.          options. When  you use  this option  (you don't  have to),  the
  3470.          time-component  of  the  date/time  of  every  file  inside the
  3471.          archive is ignored. Sometimes you need such an option when  you
  3472.          use software that use the  spare bit of the time/date  field in
  3473.          the  DOS  directory  entry.  There  are  some  programs   (some
  3474.          commercial  backup  programs)  that  do  so. When the option is
  3475.          set, all archives will get the time 00:00:00 when the  TouchHig
  3476.          or TouchLow option is active.
  3477.  
  3478.  Relate: TouchLow, TouchHig
  3479.  Dest. : All
  3480.  (*)   : Marked options are also in usage by: MTM
  3481.  
  3482.  
  3483.  ┌─────────────────────────────────────────────────────────────────────┐
  3484.  │ AcceptHighDate                                                   (*)│
  3485.  └─────────────────────────────────────────────────────────────────────┘
  3486.  Usage : Also this option belongs to the TouchHig and TouchLow  options.
  3487.          Sometimes archives  contain files  with dates  higher than  the
  3488.          current date. MTA  will give a  warning for each  of such files
  3489.          inside any archive because it could be possible that your  PC's
  3490.          date is not correctly set. If this is normal, or if you  expect
  3491.          to receive files with higher (invalid) dates, you must use  the
  3492.          AcceptHighDate option.  The actual  archive will  also get  the
  3493.          high date when TouchLow or TouchHig are in use.
  3494.  
  3495.  Relate: TouchLow, TouchHig
  3496.  Dest. : All
  3497.  (*)   : Marked options are also in usage by: MTM
  3498.  
  3499.  
  3500.  ┌─────────────────────────────────────────────────────────────────────┐
  3501.  │ NoArcInArc                                                          │
  3502.  └─────────────────────────────────────────────────────────────────────┘
  3503.  Usage : MTA will convert  any archives inside archives (in  this manual
  3504.          we call them arc-in-arc files)  up to ANY level deep  (but with
  3505.          respect to the conventional memory available).
  3506.  
  3507.          When running DOS 5.0 on 286, 386 or 486 machines, it is  normal
  3508.          to have  around 600.000  (or more)  bytes of  memory free. With
  3509.          this number of bytes free (and when swapping is used), you  can
  3510.          go up to 80  levels deep (I have  never seen such a  file). You
  3511.          need around 200K to run MTA itself and every MTA child uses  4K
  3512.          extra overhead for swapping.
  3513.  
  3514.          Normally you should  let MTA convert  any archives inside.  But
  3515.          if  memory  is  low,  or  speed  is  slow  or  disk-space  (for
  3516.          swapping)  is  low,  you  CAN  select to leave arc-in-arc files
  3517.          alone. In this case a  TEST.ZIP, containing a TEST.ARJ and  the
  3518.          target is  LZH, will  result in  TEST.LZH containing  TEST.ARJ.
  3519.          When  the  option  is  NOT  set,  it  will  result in TEST.LZH,
  3520.          containing TEST.LZH !
  3521.  
  3522.          For each level of arc-in-arc files, MTA will call itself to  do
  3523.          the  job  on  the  nested  archives,  thus  giving all possible
  3524.          options (with a few restrictions).
  3525.  
  3526.  Relate: None
  3527.  Dest. : All
  3528.  
  3529.  
  3530.  ┌─────────────────────────────────────────────────────────────────────┐
  3531.  │ OptimizeOnSize                                                      │
  3532.  └─────────────────────────────────────────────────────────────────────┘
  3533.  Usage : MTA can also be used to make the smallest possible archive.  It
  3534.          needs a  selection of  different archive  programs to  complete
  3535.          this job  and it  will convert  any archive  to the system that
  3536.          will result in  the smallest archive  (this creating a  mixture
  3537.          of a number of different target systems).
  3538.  
  3539.          All archivers  that are  included in  the xxxPath  options (see
  3540.          3.3.1, the  first options)  and that  have a  'Y' as the second
  3541.          parameter, will be used for testing.
  3542.  
  3543.          YOU must select which archivers  to include in the test.  There
  3544.          are some combinations (that can change when newer versions  hit
  3545.          the street) that are useful.  ZIP, ARJ, LZH and ZOO  (2.1x) can
  3546.          give a good  result. Including MD  or ARJ in  this list has  NO
  3547.          meaning. They ALWAYS result in a bigger archive, but the  given
  3548.          combination works.
  3549.  
  3550.          For  each  archive,  MTA  will  call the selected archivers and
  3551.          will start to  convert the archive  to each of  them (one after
  3552.          another,  only  taking  disk-space  for  one of them). When the
  3553.          smallest is known, MTA will AGAIN start the conversion but  now
  3554.          with ALL possible options (IncludeFile and such) active.
  3555.  
  3556.          OptimizeOnSize  will  cause  MTA  to  run  [number of archivers
  3557.          selected]+1 times longer (average) than normal. Only when  your
  3558.          space is limited, this option should be used !
  3559.  
  3560.  Relate: None
  3561.  Dest. : All
  3562.  
  3563.  
  3564.  ┌─────────────────────────────────────────────────────────────────────┐
  3565.  │ OnlyUpgrade                                                         │
  3566.  └─────────────────────────────────────────────────────────────────────┘
  3567.  Usage : This option can be  useful when you want to convert  your files
  3568.          to  a  higher  technical  level.  In  general, OnlyUpgrade will
  3569.          cause the following files  (also based on the  file-mask(s)) to
  3570.          convert to the new target:
  3571.  
  3572.          - Files  that are  not in  the target  format (e.g.  ZIP is the
  3573.            destination, so all non-ZIP files will be converted);
  3574.  
  3575.          - Files that ARE in the target format (e.g. ZIP and the  target
  3576.            is also ZIP) but that  have a LOWER TECHNICAL level  than the
  3577.            current target;
  3578.  
  3579.          The latter looks  somewhat difficult to  understand, so I  will
  3580.          come to the  point. ZIP, PAK  and LZH have  different levels of
  3581.          archives. You have the older  LZH 1.13 format but the  new 2.xx
  3582.          format is  different, you  have the  older PAK  (crushed) files
  3583.          and today we  have also a  new PAK format  (distilled). For ZIP
  3584.          the same rules apply.
  3585.  
  3586.          In plain english for each archiver involved:
  3587.  
  3588.          - If  the source  and target  are LZH  and the  source contains
  3589.            1.13 formatted  files, conversion  will be  done to  the 2.xx
  3590.            format with LHA;
  3591.  
  3592.          - If  the source  and target  are PAK  and the  source contains
  3593.            crushed  files,  conversion  will  be  done  to the destilled
  3594.            format with PAK;
  3595.  
  3596.          - If  the source  and target  are ZIP  and the  source contains
  3597.            either reduced 1-4 files  or imploded files, conversion  will
  3598.            be  done  to  the  ZIP  2.xx  deflated  format  (the previous
  3599.            versions of  MTA up  to 14.57  only did  an upgrade  from 1-4
  3600.            reduced to imploding, 15.01 will convert to deflated);
  3601.  
  3602.          If the source archive already  contains one or more files  from
  3603.          the NEW systems (f.i.  3 x stored but  1 x deflated), MTA  will
  3604.          not convert it when ZIP is also the target.
  3605.  
  3606.  Relate: ZIP, PAK, LZH
  3607.  Dest. : ZIP, PAK, LZH
  3608.  
  3609.  
  3610.  ┌─────────────────────────────────────────────────────────────────────┐
  3611.  │ AllDisketteFiles                                                    │
  3612.  └─────────────────────────────────────────────────────────────────────┘
  3613.  Usage : When you  use the  /D command-line  parameter (start   diskette
  3614.          conversion), MTA will only  convert archives on the  diskettes.
  3615.          If you  want to  move the  files to  another diskette (with the
  3616.          MoveToDir option) or you want to format the diskette (with  one
  3617.          of the exits),  you must make  sure that ALL  files are reMOVED
  3618.          from  the  diskette.  These  files  will  not  be converted but
  3619.          (temporary) moved to the same directory as where the  converted
  3620.          files are stored (temporary). You can instruct MTA to move  ALL
  3621.          files from the diskette (and back!) by setting this option.
  3622.  
  3623.          Diskette  conversion  is  not  possible  when  the  OnlyUpgrade
  3624.          option is set !
  3625.  
  3626.  Relate: EXITBeforeFill, EXITAfterFill, MoveToDir
  3627.  Dest. : All
  3628.  
  3629.  
  3630.  ┌─────────────────────────────────────────────────────────────────────┐
  3631.  │ MakeArc [mask]                                                      │
  3632.  └─────────────────────────────────────────────────────────────────────┘
  3633.  Usage : MTA  is  able  to  convert  ANY NON-ARCHIVE file that is in the
  3634.          working  directory  when  it  has  started to convert archives.
  3635.          To  instruct  MTA  to  do such a thing, you must include one or
  3636.          more MakeArc (and optionally MakeArcExclude) option(s).
  3637.  
  3638.          [mask]        This must be a valid DOS (4DOS <tm> or DISP <tm>)
  3639.                        filemask (up to 12 characters, wildcards allowed)
  3640.                        of (a) non-archived file(s) that MTA must convert
  3641.                        along the way;
  3642.  
  3643.          MTA will convert all matching files to archives of the selected
  3644.          target-type on a one-to-one basis. An example:
  3645.  
  3646.          MakeArc *.*
  3647.  
  3648.          MTA detects the following files in the working directory:
  3649.  
  3650.          A.ZIP
  3651.          B.ARJ
  3652.          C.WAV
  3653.          D.DOC
  3654.          E.GIF
  3655.          Z.ZOO
  3656.  
  3657.          With a destination (target) of ZIP, the following will happen:
  3658.  
  3659.          A.ZIP will be converted to  A.ZIP
  3660.          B.ARJ  ,,  ,,    ,,     ,,  B.ZIP
  3661.          C.WAV  ,,  ,, archived into C.ZIP
  3662.          D.DOC  ,,  ,, archived into D.ZIP
  3663.          E.GIF  ,,  ,, archived into E.ZIP
  3664.          Z.ZOO  ,,  ,, converted to  Z.ZIP
  3665.  
  3666.          With  this example, MTA  will  archive every SINGLE file into a
  3667.          SINGLE archive. There can be up to 255 MakeArc options.
  3668.  
  3669.  Relate: MakeArcExclude
  3670.  Dest. : All
  3671.  
  3672.  
  3673.  ┌─────────────────────────────────────────────────────────────────────┐
  3674.  │ MakeArcExclude [mask]                                               │
  3675.  └─────────────────────────────────────────────────────────────────────┘
  3676.  Usage : This option  can be used in combination with the MakeArc option
  3677.          and can  be  used to narrow the selection of non-archived files
  3678.          that will be converted to an archive.
  3679.  
  3680.          [mask]        This must be a valid DOS (4DOS <tm> or DISP <tm>)
  3681.                        filemask (up to 12 characters, wildcards allowed)
  3682.                        of (a) non-archived file(s) that MTA must exclude
  3683.                        from the MakeArc process;
  3684.  
  3685.          MTA  will  exclude  all matching files from the archive process
  3686.          that is initialized by the MakeArc option(s). An example:
  3687.  
  3688.          MakeArc *.*
  3689.          MakeArcExclude *.GIF
  3690.          MakeArcExclude *.WAV
  3691.  
  3692.          MTA detects the following files in the working directory:
  3693.  
  3694.          A.ZIP
  3695.          B.ARJ
  3696.          C.WAV
  3697.          D.DOC
  3698.          E.GIF
  3699.          Z.ZOO
  3700.  
  3701.          With a destination (target) of ZIP, the following will happen:
  3702.  
  3703.          A.ZIP will be converted to  A.ZIP
  3704.          B.ARJ  ,,  ,,    ,,     ,,  B.ZIP
  3705.          C.WAV  ,,  ,, archived into C.WAP
  3706.          D.DOC  ,,  ,, archived into D.ZIP
  3707.          E.GIF  ,,  ,, left alone as E.GIF  <------------
  3708.          Z.ZOO  ,,  ,, converted to  Z.ZIP
  3709.  
  3710.          With this  example, MTA  will  archive every SINGLE file into a
  3711.          SINGLE archive except GIF files !
  3712.  
  3713.  Relate: MakeArc
  3714.  Dest. : All
  3715.  
  3716.  
  3717.  ┌─────────────────────────────────────────────────────────────────────┐
  3718.  │ KeepAbnormalExtensions                                              │
  3719.  └─────────────────────────────────────────────────────────────────────┘
  3720.  Usage : Some of  the archives contain a  special extension that is  not
  3721.          common with the archive system. You can receive files with  the
  3722.          extension  .A25,  .SDN  and  so  on.  Normally MTA will convert
  3723.          these archives (unless excluded  by DoNot or the  file-mask) to
  3724.          a  new  archive  with  a  NORMAL  extension  (e.g. ZIP when you
  3725.          convert to ZIP). If you include this option, MTA will keep  the
  3726.          abnormal extension even after the conversion. So A.SDN (in  ZIP
  3727.          format), converted to ARJ, will still be called A.SDN.
  3728.  
  3729.          Only one archive system can not work with abnormal  extensions.
  3730.          DWC can only  work with archives  that end with  .DWC. When you
  3731.          convert A.SDN (in ZIP format) to DWC, the result will be  named
  3732.          A.DWC !
  3733.  
  3734.  Relate: None
  3735.  Dest. : All
  3736.  
  3737.  
  3738.  ┌─────────────────────────────────────────────────────────────────────┐
  3739.  │ WeekExtension [ext] [letter]                                        │
  3740.  └─────────────────────────────────────────────────────────────────────┘
  3741.  Usage : There are archives with a very special extension. These are the
  3742.          archives that (f.i.) contain the BBS-nodelist and BBS-nodediff
  3743.          files. These extensions are made up by a letter (normally a A)
  3744.          and two digits that are the last two digits of a day-number.
  3745.          In this manner, files with names like NODEDIFF.A21 can be found
  3746.          on various BBS's.
  3747.  
  3748.          There have been some proposals and standards as how to use these
  3749.          extensions for BBS-nodelist/nodediff files. As fas as I know,
  3750.          there is only one valid standard and that is the usage of ARC
  3751.          (SEA ARC, crunched) files with extension Axx (xx are the last
  3752.          two digits of the day-number). Some nets use other archivers
  3753.          for these files (like ZIP, ARJ and LZH). To keep a difference
  3754.          between these SEA ARC (Axx) files and those converted to any of
  3755.          the other systems, nets use different letters. As such the
  3756.          following list looks more or less standard (but is not covered
  3757.          by a formal fidonet-standard):
  3758.  
  3759.          SEA ARC         xxxxxxxx.Ann
  3760.          ZIP             xxxxxxxx.Znn
  3761.          ARJ             xxxxxxxx.Jnn
  3762.          LZH/LZS         xxxxxxxx.Lxx
  3763.  
  3764.          MTA can be used to maintain such a  system. Normally,  you  can
  3765.          supply   the  KeepAbnormalExtensions  option  to  maintain  the
  3766.          original extension of a file, but this would cause NODEDIFF.A10
  3767.          to keep  its original  extension  (A10)  even when  the file is
  3768.          actually converted to ZIP (Z10 would be better).
  3769.  
  3770.          You can  use  the  WeekExtension option(s) (up to 20) to inform
  3771.          MTA how  files  with the an extension made up by one letter and
  3772.          two  digits  (A01,  Z11, J18 and so on) should be (re)named. If
  3773.          you do not supply this option, MTA will either convert the name
  3774.          to a  normal  archive-extension or to the original extension if
  3775.          the  KeepAbnormalExtensions option is active. The WeekExtension
  3776.          option is set for the target-file !
  3777.  
  3778.          [ext]         This parameter must  be set to the NORMAL archive
  3779.                        extension  that  the  target-file would have been
  3780.                        given (like ZIP, ARJ, ARC and so on);
  3781.  
  3782.          [letter]      This  parameter  must be set to the letter of the
  3783.                        new  extension  that belongs to [ext] (like Z for
  3784.                        ZIP, L of LZH/LZS or J for ARJ).
  3785.  
  3786.          When  MTA  starts  converting an archive with an extension that
  3787.          is made  up  by  a letter and two numbers AND the new extension
  3788.          that the  archive  should  get under normal conditions (LZH for
  3789.          LHarc, ZIP  for  ZIP,  ARJ  for  ARJ and so on) is defined by a
  3790.          WeekExtension  option,  MTA  will  use  the supplied letter and
  3791.          will create  a  new extension with this letter and the original
  3792.          two digits. For example:
  3793.  
  3794.          WeekExtension ARC A
  3795.          WeekExtension ZIP Z
  3796.          WeekExtension LZH L
  3797.          WeekExtension LZS L
  3798.          WeekExtension ARJ J
  3799.  
  3800.          Source-archive  is  called  NODEDIFF.A12 and conversion is done
  3801.          to ZIP.  ZIP  is inside the array and 'owns' letter 'Z', so the
  3802.          new archive  will  be called NODEDIFF.Z12. Source is RA.H11 and
  3803.          conversion is  done  to ARJ. ARJ is in the array and 'owns' the
  3804.          letter 'J' so  the new archive is called RA.J11. Source archive
  3805.          is  called  DISP.J01  and conversion is done to HYPER. HYP (the
  3806.          extension  for  a normal HYPER archive) is NOT in the array so,
  3807.          unless  KeepAbnormalExtensions  is set, the new archive will be
  3808.          called DISP.HYP !
  3809.  
  3810.          Because  of the lack of rules for the conversion of extensions,
  3811.          MTA uses a 'dynamic' system.
  3812.  
  3813.  Relate: KeepAbnormalExtensions
  3814.  Dest. : All
  3815.  
  3816.  
  3817.  ┌─────────────────────────────────────────────────────────────────────┐
  3818.  │ FixedConversion [mask] [target]                                     │
  3819.  └─────────────────────────────────────────────────────────────────────┘
  3820.  Usage : There can  be  up  to 255 of these options in MTA.CTL. For each
  3821.          file  that  is  selected  for  processing, MTA  will look if it
  3822.          matches  any [mask] in  the FIXEDCONVERSION option. If the name
  3823.          matches  [mask] (the first  match will count), MTA will convert
  3824.          the file  to  the [target] format EVEN if the default format is
  3825.          something else.
  3826.  
  3827.          [mask]        This must be a valid DOS (4DOS <tm> or DISP <tm>)
  3828.                        filemask (up to 12 characters, wildcards allowed)
  3829.                        that will have a fixed conversion;
  3830.  
  3831.          [target]      This must be a valid name of the  target archiver
  3832.                        (or convertor  in case  of  GIF-alike files). The
  3833.                        valid names  are  the same as you supply with the
  3834.                        COMPRESSIONTYPE  option (ZIP,  ARJ, ARC, ZOO, GIF
  3835.                        and so on);
  3836.  
  3837.          For example:
  3838.  
  3839.          FixedConversion NODELIST.A?? ARC
  3840.          FixedConversion NODEDIFF.A?? ARC
  3841.  
  3842.          Will force  MTA to  convert  any selected file with one of that
  3843.          names, to the  ARC  format, even  if the selected target-format
  3844.          is ZIP.
  3845.  
  3846.          This option comes in handy when certain files always have to be
  3847.          converted to a fixed system.
  3848.  
  3849.          All other options like WEEKEXTENSION and KEEPABNORMALEXTENSION
  3850.          will still word.
  3851.  
  3852.  Relate: None
  3853.  Dest. : All
  3854.  
  3855.  
  3856.  ┌─────────────────────────────────────────────────────────────────────┐
  3857.  │ ReportSpecialAttributes                                             │
  3858.  │ ReportSpecialAttributes SKIP                                        │
  3859.  └─────────────────────────────────────────────────────────────────────┘
  3860.  Usage : Some archives  can contain files with  abnormal file-attributes
  3861.          like  HIDDEN,  READONLY  and/or  SYSTEM.  If  the decompression
  3862.          program is  able to  decompress these  files in  this way,  you
  3863.          could be in for trouble (though MTA will remove any left  files
  3864.          after the conversion). If you like to, MTA can report  archives
  3865.          that contain such files when you set this option. Also, when
  3866.          this option is set, MTA will reset all attributes that are not
  3867.          'normal' (READONLY, HIDDEN and SYSTEM) before the new archive
  3868.          is created.
  3869.  
  3870.          When SKIP is supplied, MTA will not convert the attributes and
  3871.          will not even convert the archive. The archive is moved to the
  3872.          error-directory and conversion must be done by hand.
  3873.  
  3874.  
  3875.  Relate: None
  3876.  Dest. : All
  3877.  
  3878.  
  3879.  ┌─────────────────────────────────────────────────────────────────────┐
  3880.  │ ReportInvalidFiles                                                  │
  3881.  └─────────────────────────────────────────────────────────────────────┘
  3882.  Usage : It is  invalid  (and dangerous) when an archive contains one of
  3883.          more  files  with  a name equal to a device-name in your PC. To
  3884.          overcome any  problems  with  these archives, you should remove
  3885.          them !
  3886.  
  3887.          MTA is  (optionally)  able  to  test  EVERY filename inside the
  3888.          archive  against  ALL  CURRENT  device-driver  names  you  have
  3889.          active  in your  PC. If  you  set  this  option  (it  is highly
  3890.          recommened  that  you  do  so),  MTA  will perform these checks,
  3891.          otherwise  (no option)  it  won't.  Testing  of  all files will
  3892.          only take a few moments extra !
  3893.  
  3894.          In  general, only  when  this  option  will  cause  problems in
  3895.          your PC,  you  should  not  include  it, otherwise  include the
  3896.          option !
  3897.  
  3898.  Relate: None
  3899.  Dest. : All
  3900.  
  3901.  
  3902.  ┌─────────────────────────────────────────────────────────────────────┐
  3903.  │ KeepAV                                                              │
  3904.  └─────────────────────────────────────────────────────────────────────┘
  3905.  Usage : Both ARJ and ZIP can create archives with a special  attribute,
  3906.          called  the  security  envelope/Authentification  Verification.
  3907.          Normally these files are created by the original author of  the
  3908.          program(s) that are included and  the code functions as a  kind
  3909.          of proof that the file  is untouched by others (virus,  patches
  3910.          and so on). One piece of  bad luck is that some BBS's  also use
  3911.          the  AV/Security  Envelope  to  mark  these  files as 'theirs',
  3912.          destroying the original idea behind the AV/SE code.
  3913.  
  3914.          When you  want to  keep files  with a  valid AV/SE  as they are
  3915.          (and you should  do so, certainly  on a BBS),  you must include
  3916.          this option.  If MTA  detects such  an archive  it will  do the
  3917.          following:
  3918.  
  3919.          - Decompress the file
  3920.  
  3921.          - Test for any virus (still)
  3922.  
  3923.          - Perform the exists involved;
  3924.  
  3925.          - Remove all decompressed files;
  3926.  
  3927.          - Include any new files to the original file (only ZIP);
  3928.  
  3929.          - Add comments to the original file (only ZIP);
  3930.  
  3931.          - If the  source is an  SFX, it CAN  be converted to  a non-SFX
  3932.            file of the same system (when you set the SFXFiles option);
  3933.  
  3934.          The  original  archive  is  kept  as  it was. Only some special
  3935.          files could be added and, optionally a comment header (ZIP).
  3936.  
  3937.  Relate: IncludeAVFile
  3938.  Dest. : All
  3939.  
  3940.  
  3941.  ┌─────────────────────────────────────────────────────────────────────┐
  3942.  │ IncludeAVFile [filemask] {AVCode}                                   │
  3943.  └─────────────────────────────────────────────────────────────────────┘
  3944.  Usage : As you have read  in the previous option, there are  situations
  3945.          where the  AV/SE code  has NO  meaning whatsoever.  You can use
  3946.          this option to instruct MTA  WHICH AV/SE files must keep  their
  3947.          code. All  others will  be stripped  EVEN if  the KeepAV option
  3948.          forces MTA not to do so.
  3949.  
  3950.          [filemask]    The parameter must  contain a single   file-mask.
  3951.                        You  can  use  the  normal  DOS  wildcards (?,*).
  3952.                        Also  a  special  wildcard  (=)  can be used. '='
  3953.                        will test  for a  shifting match.  So '=WAR' will
  3954.                        match  tradeWAR.zip  and  also  WARning.ARC.  =FZ
  3955.                        will NOT  match with  nodedifF.Zip. In  this case
  3956.                        you  must  use  =F.Z.   You  must  only include a
  3957.                        file-mask and not a directory and/or drive;
  3958.  
  3959.          {AVCode}      When this  parameter  is  NOT  present, all files
  3960.                        that  match  [filemask]  will  keep their AV-code
  3961.                        (e.g.  they  will  not be converted) if KeepAV is
  3962.                        set. You  can  also  supply  a  valid  AV-code or
  3963.                        AV-code-mask  overhere. In  this  case, all files
  3964.                        that  match  [filemask] AND  that  match {AVCode}
  3965.                        will  keep  their  AV-code (e.g. they will not be
  3966.                        converted)  when  KeepAV  is  set. You can either
  3967.                        supply  a  full  AV-code  overhere (like 0000 for
  3968.                        the  AV-code  that comes with original ARJxxx.EXE
  3969.                        distribution  file  or PKW655 that comes with the
  3970.                        original  PKLTExxx.EXE file)  or a mask. The mask
  3971.                        can  include  2  types of characters.  Either a #
  3972.                        (for numeric  digit)  or @ (for alphabetic digit)
  3973.                        can be  used in combination with real digits. For
  3974.                        example,  P@W###  will  cause  a match for PKW655
  3975.                        but NOT for P1WA11;
  3976.  
  3977.          Most obvious  you would  like to  keep the  AV/E codes for some
  3978.          general  files  like SCAN*.*, CLEAN*.*, 4DOS*.* and so on. Some
  3979.          examples are included in the archive. Some general hits:
  3980.  
  3981.          - When you want to keep all ZIP AV-codes, you can supply
  3982.            IncludeAVFile *.* @@@###
  3983.          - When you want to keep all ARJ AV-codes, you can supply
  3984.            IncludeAVFile *.* ####
  3985.          - Independent of the IncludeAVFile options you MUST set the
  3986.            KeepAV option to actually KEEP the AV-codes (e.g. no con-
  3987.            version of the archive). If there is a matching IncludeAVFile
  3988.            but NO KeepAV option, the archive will still be converted;
  3989.  
  3990.          There can be up to 512 IncludeAVFile options in MTA.CTL !
  3991.  
  3992.  Relate: KeepAV, ExcludeAVFile
  3993.  Dest. : All
  3994.  
  3995.  
  3996.  ┌─────────────────────────────────────────────────────────────────────┐
  3997.  │ ExcludeAVFile [filemask] [AVCode] {KEEP│DELETE│MOVE}                │
  3998.  └─────────────────────────────────────────────────────────────────────┘
  3999.  Usage : This option works is  the reversed of the IncludeAVFiles option
  4000.          described above. The  combination of In- and ExcludeAVFiles can
  4001.          result in  a  very nifty  management of archives with AV-codes.
  4002.          The number of ExcludeAVFile options that can be used is 512.
  4003.  
  4004.          The  ExcludeAVFile  option  is  tested  AFTER  A MATCH from the
  4005.          IncludeAVFile  is  found. If  it then matches the ExcludeAVFile
  4006.          option, it  is  again  excluded  AV  operation an the AV is not
  4007.          kept. If  you  did not use any IncludeAVFile (but KeepAV is set)
  4008.          you can  still use this option. In this case ALL AV'ed archives
  4009.          match (e.g. there  is  no  specific  IncludeAVFile) and you can
  4010.          exclude them again with this option.
  4011.  
  4012.          The  first  two  parameters for the ExcludeAVFile opion are the
  4013.          same as those on the IncludeAVFile option.
  4014.  
  4015.          The ExcludeAVFile  option  can use an extra parameter (when you
  4016.          compare it  with  the IncludeAVFile option). This parameter can
  4017.          have the following value:
  4018.  
  4019.          KEEP   : KEEP is the  default  so it can be left out. When KEEP
  4020.                   mode is  selected, MTA  will  leave  the AV'ed archive
  4021.                   when it matches the ExcludeAVFile option in question;
  4022.  
  4023.          MOVE   : When MOVE is used and the AV'ed archive will match the
  4024.                   given  ExcludeAVFile  option, the file is MOVED to the
  4025.                   error directory;
  4026.  
  4027.          DELETE : When DELETE  is  used and the AV'ed archive will match
  4028.                   the given  ExcludeAVFile  option,  the file is deleted
  4029.                   from  the  disk. This  comes in handy when you want to
  4030.                   remove  all  bogus-files  with a bogus-AVcode. Because
  4031.                   both the  ARJ  and ZIP AV-codes are cracked, there are
  4032.                   some  bogus  codes  in  the  circuit. If you know one,
  4033.                   you  can  include  the  ExcludeAVFile  option for this
  4034.                   AV-code, along with the DELETE option;
  4035.  
  4036.          Example 1:
  4037.  
  4038.          IncludeAVFile *.* ####            (include all ARJ's)
  4039.          IncludeAVFile *.* @@@###          (include all ZIP's)
  4040.          ExcludeAVFile *.* 0123    KEEP    (EXclude ARJ AV 123)
  4041.  
  4042.          A file A.ZIP enters  with AV-code PKQ001. It matches the second
  4043.          IncludeAVFile option  and does not match the ExcludeAVFile. Now
  4044.          a B.ARJ with code  123 enters. This  file  matches the first of
  4045.          the IncludeAVFile  options  but  also matches the ExcludeAVFile
  4046.          option. It is kept as it was and no conversion will take place.
  4047.  
  4048.          Example 2:
  4049.  
  4050.          IncludeAVFile MT*.* RVH001
  4051.          ExcludeAVFile M*.*  RVH001 DELETE
  4052.  
  4053.          MTA_VXXX.ZIP  with AV-code  RVH001 enters. It matches MT*.* but
  4054.          also M*.* and  is  deleted. Both  Include and exclude match but
  4055.          the exclude is tested last and has a higher priority !
  4056.  
  4057.  Relate: KeepAV, IncludeAVFile
  4058.  Dest. : All
  4059.  
  4060.  
  4061. │┌─────────────────────────────────────────────────────────────────────┐
  4062. ││ KeepAVNoCode                                                        │
  4063. │└─────────────────────────────────────────────────────────────────────┘
  4064. │Usage : If MTA is  unable  to  extract  the AV-code or AV-user from the
  4065. │        archive  (see AVCODES.TEC file) where the original file 'looks'
  4066. │        like a file  that  has an AV-code, MTA will mark those files as
  4067. │        NOT having  the AV-code  and they are converted. If you include
  4068. │        this option, MTA  will  always  KEEP the file in original state
  4069. │        (when  KEEPAV  is  also  included), though  there  is  no check
  4070. │        against the  IncludeAVFile  and  ExcludeAVFile options possible
  4071. │        (there is no AV-code/AV-user obtained from the archive);
  4072. │
  4073. │Relate: KeepAV, IncludeAVFile, ExcludeAVFile
  4074. │Dest. : All
  4075.  
  4076.  
  4077.  ┌─────────────────────────────────────────────────────────────────────┐
  4078.  │ KeepVolLabel                                                        │
  4079.  └─────────────────────────────────────────────────────────────────────┘
  4080.  Usage : Both ARJ and ZIP can contain (optionally) a volume label.  This
  4081.          is  sometimes  used  for  ARJ/ZIP  files  that are a compressed
  4082.          image of a diskette.
  4083.  
  4084.          MTA uses some  special techniques to  enforce the volume  label
  4085.          inside a  ZIP or  ARJ (if  any). The  technique only works when
  4086.          you have the SubstDrive option set and is as follows:
  4087.  
  4088.          - The current  volume-label of the  substituted drive is  read.
  4089.            This is the same label  as the drive containing the  ORIGINAL
  4090.            directory that is now used  for the substitution (in fact  it
  4091.            IS the volume label of that drive);
  4092.  
  4093.          - The ARJ or  ZIP is read. If  it contains no volume-label,  it
  4094.            will be converted as normal;
  4095.  
  4096.          - If it  contains a volume-label,  MTA will decompress  it with
  4097.            the option to decompress the volume-label as well;
  4098.  
  4099.          - The target system will  be called to compress the  file again
  4100.            (if it supports volume-labels,  those options are also  added
  4101.            by MTA);
  4102.  
  4103.          - MTA will reset  the volume-label to the original value unless
  4104.            there was no previous value, in which case MTA will set the
  4105.            label to MTA TMP LBL;
  4106.  
  4107.  Relate: None
  4108.  Dest. : ZIP, ARJ
  4109.  
  4110.  
  4111. │┌─────────────────────────────────────────────────────────────────────┐
  4112. ││ NoCloakedArchives {ALL}                                             │
  4113. │└─────────────────────────────────────────────────────────────────────┘
  4114. │Usage : Some achives are repacked recursively. For example, someone has
  4115. │        created MYFILES.ZIP (with 15 files inside). Now  this  file  is
  4116. │        for some  reason  packed  again  to MYFILES.ZIP. You now have a
  4117. │        file  MYFILES.ZIP  with  ONE  file  inside  (MYFILES.ZIP). This
  4118. │        included  file  contains  the real files. This type of files is
  4119. │        very dangerous  to process from the command-line. If you should
  4120. │        unpack  MYFILES.ZIP  with 'PKUNZIP MYFILES.ZIP', PKUNZIP  would
  4121. │        report a message, asking to overwrite the existing file. If you
  4122. │        answer 'Y'es, PKUNZIP will start doing so and while the work is
  4123. │        in  progress,  PKUNZIP  could  overwrite  parts of the original
  4124. │        archive  MYFILES.ZIP  with  new  data  from  the extracted file
  4125. │        MYFILES.ZIP. This will cause  a damaged source AND target file.
  4126. │
  4127. │        On BBS's  this  type of archives is sometimes created to show a
  4128. │        newer  file-date  than  the  actual  files  inside  are (a  bad
  4129. │        behaviour) or  it  can  happen as a result of a conversion of a
  4130. │        complete  package  (originally  containing INSTALL.ARC which is
  4131. │        now converted to, lets say, INSTALL.ZIP).
  4132. │
  4133. │        If you include  the  NoCloakedArchives option, MTA will test if
  4134. │        the  archive  will  ontain  ONE file AND that file has the same
  4135. │        name  as  the  original archive. You can also add the parameter
  4136. │        ALL in  which case MTA will test of ANY file inside the archive
  4137. │        has the  same name as the archive itself. When the test matches,
  4138. │        MTA will move the archive to the error-directory.
  4139. │
  4140. │Relate: None
  4141. │Dest. : All
  4142.  
  4143.  
  4144.  ┌─────────────────────────────────────────────────────────────────────┐
  4145.  │ SkipBackups                                                         │
  4146.  └─────────────────────────────────────────────────────────────────────┘
  4147.  Usage : Both ARJ and ZOO can contain (optionally) backups. These  files
  4148.          are normally not  decompressed by MTA  and will be  lost unless
  4149.          you have set special options for both ARJ and ZOO.
  4150.  
  4151.          If you want  to keep the  backups, you can  force MTA to  leave
  4152.          this archives as they were. In fact, they are skipped when  you
  4153.          supply this option  ! Normal ARJ/ZOO  files that DON'T  contain
  4154.          backup versions are processed as before.
  4155.  
  4156.  Relate: None
  4157.  Dest. : ZOO, ARJ
  4158.  
  4159.  
  4160.  ┌─────────────────────────────────────────────────────────────────────┐
  4161.  │ OverwriteDuplicates                                                 │
  4162.  └─────────────────────────────────────────────────────────────────────┘
  4163.  Usage : Normally  MTA will never  overwrite any duplicate  file. If you
  4164.          convert A.ZIP  and A.ARJ  to ZOO,  it will  result in A.ZOO and
  4165.          A.ZO1 (the second  archive will be  renamed but will  NOT erase
  4166.          the other). If you  supply the OverwriteDuplicates option,  MTA
  4167.          WILL overwrite any file with the same name. This also goes for
  4168.          files that are moved to the error-directory and/or the trashcan
  4169.          directory !
  4170.  
  4171.  Relate: None
  4172.  Dest. : All
  4173.  
  4174.  
  4175.  ┌─────────────────────────────────────────────────────────────────────┐
  4176.  │ Description                                                         │
  4177.  └─────────────────────────────────────────────────────────────────────┘
  4178.  Usage : Most archivers have the  option to add a description to  one or
  4179.          more (or all)  components inside the  archive. If you  set this
  4180.          option, MTA  will add  options for  the target  to ask for such
  4181.          comments. THIS IS MANUAL WORK,  DON'T USE THIS OPTION WHEN  MTA
  4182.          MUST RUN UNATTENDED !!
  4183.  
  4184.  Relate: Autodescription
  4185.  Dest. : All
  4186.  
  4187.  
  4188.  ┌─────────────────────────────────────────────────────────────────────┐
  4189.  │ Autodescription [path]                                           (*)│
  4190.  └─────────────────────────────────────────────────────────────────────┘
  4191.  Usage : When you want to include a comment header in your target  file,
  4192.          you can use this option to do so (automatically). Those  target
  4193.          systems that  support it,  will be  instructed to  add a common
  4194.          header  to  each  and  every  converted  archive. Currently the
  4195.          comment can be added to ZIP, ZOO, ARJ and PAK files.
  4196.  
  4197.          [path]        This value must point to a valid  drive/directory
  4198.                        and  filename  of  the  file  which  include  the
  4199.                        actual comment.   If no  drive is  supplied,  the
  4200.                        default  one  is   used.   Relative   directories
  4201.                        (..\WRKDIR and such) are  not advised but can  be
  4202.                        used   (the   are   counted   from   the  CURRENT
  4203.                        directory).    The   file   must   be   a  normal
  4204.                        text-file. It can be a ANSI file (not  preferred,
  4205.                        most  archivers   won't  display   ANSI-sequences
  4206.                        unless specifically told, because ANSI  sequences
  4207.                        can  reconfigure  the  key-  board.  You would be
  4208.                        surprises and angry to  see that F3 now  starts a
  4209.                        FORMAT  of  your  hard-disk),  but  a normal pain
  4210.                        ASCII file  is best.  The total  size can  not be
  4211.                        greater than 64000 bytes.
  4212.  
  4213.          The AutoDescription can also be combined with the  CarryComment
  4214.          option (see BBS options) to gain maximum result !
  4215.  
  4216.          MTA uses the quickest  but safest way to  add the comment to  a
  4217.          file. In most cases piping  will be used (PKZIP -z  A <comment)
  4218.          but sometimes special options.
  4219.  
  4220.  Relate: Description
  4221.  Dest. : ARJ, ZIP, ZOO, PAK
  4222.  (*)   : Marked options are also in usage by: MTM
  4223.  
  4224.  
  4225.  3.3.6 Your own (new) compressor
  4226.  ───────────────────────────────────────────────────────────────────────
  4227.  The following  statements can  be used  to define  a compressor that is
  4228.  not (yet)  included in  MTA. If  you find  a compressor  that meets the
  4229.  standard to be included into MTA then please contact the author.
  4230.  
  4231.  Your OWN compression and decompression programs must follow some  basic
  4232.  rules and it is only needed to  include them if they are not yet  added
  4233.  to the STANDARD MTA support. The following rules apply:
  4234.  
  4235.  - They must report an errorlevel higher than 0 if errors occur;
  4236.  
  4237.  - The first errorlevel that reports  an error can not be followed  by a
  4238.    higher errorlevel that does NOT report an error;
  4239.  
  4240.  - The compressor MUST have an  option to delete the files it  has added
  4241.    to the archive;
  4242.  
  4243.  - The decompressor CAN have  recursive support. This also goes  for the
  4244.    compressor. It is not mandatory;
  4245.  
  4246.  - You can NOT use a batch-file to call the compressor/decompressor;
  4247.  
  4248.  - The  compression  system  must  use  its  own  extension (CRA in  the
  4249.    following examples);
  4250.  
  4251.  - Sometimes  you can  use the  support for  OWN compressors to overrule
  4252.    the  normal  compression/decompression  programs  that  MTA  supports
  4253.    internally, but you are on your own;
  4254.  
  4255.  
  4256.  ┌─────────────────────────────────────────────────────────────────────┐
  4257.  │ OwnCompressPath   [path] {opt} {DynSwapSiz} {second path}           │
  4258.  │ OwnDeCompressPath [path] {opt} {DynSwapSiz} {second path}           │
  4259.  └─────────────────────────────────────────────────────────────────────┘
  4260.  Usage : For your own  compression and decompression program, these  two
  4261.          statements must  be included.  The syntax  is the  same as  all
  4262.          other  xxxPath  options.  OwnCompressPath and OwnDecompressPath
  4263.          must point  to the  same file  if compression/decompression  is
  4264.          combined in one program.
  4265.  
  4266.  Relate: All Own-options
  4267.  Dest. : OWN
  4268.  
  4269.  
  4270.  ┌─────────────────────────────────────────────────────────────────────┐
  4271.  │ OwnCompressCall   [parms2use]                                       │
  4272.  │ OwnDeCompressCall [param2use]                                       │
  4273.  └─────────────────────────────────────────────────────────────────────┘
  4274.  Usage : When  using a customized  compression program, you  must supply
  4275.          the  parameters  to  be  passed  to  this program in the option
  4276.          OwnCompressCall.  For  any  decompression,  you must supply the
  4277.          parameters in the OwnDecompressCall option.
  4278.  
  4279.          [parms2use]   This parameter  must be  set in  a way  that  the
  4280.                        following sequence is started for compression:
  4281.  
  4282.                        - Compress all files in the current directory  in
  4283.                          the new archive;
  4284.  
  4285.                        - Delete all files from the current directory  or
  4286.                          compress with a move option (implicit delete);
  4287.  
  4288.                        This  parameter  must  be  set  in a way that the
  4289.                        following sequence is started for decompression:
  4290.  
  4291.                        - DeCompress all  files in the  current directory
  4292.                          from  the  new  archive;  The  name  of the new
  4293.                          archive is included  at the location  where you
  4294.                          add %1 in this parameter.
  4295.  
  4296.  Relate: All Own-options
  4297.  Dest. : OWN
  4298.  
  4299.  
  4300.  ┌─────────────────────────────────────────────────────────────────────┐
  4301.  │ OwnCompressLowErrorRC   [errornumber]                               │
  4302.  │ OwnDecompressLowErrorRC [errornumber]                               │
  4303.  └─────────────────────────────────────────────────────────────────────┘
  4304.  Usage : When  you  include   a  customized (de)compressor, you have  to
  4305.          supply the  LOWEST DOS  errorlevel given  by the (de)compressor
  4306.          when something is WRONG.
  4307.  
  4308.          [errornumber] This  parameter  must  be  the lowest  errorlevel
  4309.                        returned  by  the  (de)compression  program  when
  4310.                        something is wrong. Values must be between 1  and
  4311.                        255;
  4312.  
  4313.  Relate: All Own-options
  4314.  Dest. : OWN
  4315.  
  4316.  
  4317.  ┌─────────────────────────────────────────────────────────────────────┐
  4318.  │ OwnExtension [extension]                                            │
  4319.  └─────────────────────────────────────────────────────────────────────┘
  4320.  Usage : When  you want MTA  to 'see' your  customized compressed files,
  4321.          you have to supply  the name of the  extension MTA has to  look
  4322.          for. This can only be 1 extension (e.g. OWN).
  4323.  
  4324.          [extension]   This parameter must  be the (up to 3 bytes  long)
  4325.                        extension of the compressed files that are  ruled
  4326.                        under the OWN options.
  4327.  
  4328.          For every file that confirms to the supplied file-mask(s),  MTA
  4329.          will FIRST look if it  has an 'OwnExtension'. In that  case MTA
  4330.          will decompress  the file  with the  supplied decompressor.  If
  4331.          the destination is OWN, MTA instruct the customized  compressor
  4332.          to create files with extension 'OwnExtension'.
  4333.  
  4334.  Relate: All Own-options
  4335.  Dest. : All, including source OWN
  4336.  
  4337.  
  4338.  ┌─────────────────────────────────────────────────────────────────────┐
  4339.  │ OwnRecursive                                                        │
  4340.  └─────────────────────────────────────────────────────────────────────┘
  4341.  Usage : When you implement a  compressor, you have to tell MTA  if that
  4342.          compressor  is  capable  of  handling  recursive  support. This
  4343.          means that  the compressor  will look  in the  current and  all
  4344.          lower directories. If the customized compressor can not  handle
  4345.          recursive support, you must leave out this option out.
  4346.  
  4347.  Relate: All Own-options
  4348.  Dest. : OWN
  4349.  
  4350.  
  4351.  3.3.7 Statements that define the various exits (hooks) in MTA
  4352.  ───────────────────────────────────────────────────────────────────────
  4353.  The following statements can be used  to define one or more exits.  The
  4354.  exit points in MTA  can be used to  call other programs, before,  while
  4355.  or after  the compression  and/or start  and end  of MTA.  Some of  the
  4356.  exits like the  VirusScanner option are  advised, the others  are up to
  4357.  you !
  4358.  
  4359.  ┌─────────────────────────────────────────────────────────────────────┐
  4360.  │ VirusScanner [desc] [crt] [swap] [lowe] {highe} [path] [parm] {parm}│
  4361.  └─────────────────────────────────────────────────────────────────────┘
  4362.  Usage : One of the major topics  on the PC today is the virus.  MTA has
  4363.          specific support for the scan  for a virus. The scanning  (when
  4364.          active) is done  after the decompression  of the files  (before
  4365.          the removal of any files that match any ExcludeFile option).
  4366.  
  4367.          Which scanner(s) you want  to use is fully  up to you. MTA  can
  4368.          support  a  wide  range  of  scanners.  MTA  is tested with the
  4369.          following scanners  (examples for  their calls  are included in
  4370.          the sample MTA.CTL inside the distribution archive):
  4371.  
  4372.          - Scan     by McAfee <tm>
  4373.          - TBScan   by Frans Veldman <tm>
  4374.          - HTScan   by Harry Thijssen <tm>
  4375.          - VIRX     by Microcom Software Division <tm>
  4376.          - CPAV     by Central Point Software <tm> (Version 1.2 and up)
  4377.          - FINDVIRU by S&S International <tm> (Dr. Solomon)
  4378.  
  4379.          With  the  current   version  of  MTA,   up to 10 scanners  can
  4380.          be  included.  If  a  file  contains   a  virus, the archive is
  4381.          moved to  the error-directory  and marked  with special  0-byte
  4382.          files.  Also  further processing of  THIS file   is aborted and
  4383.          MTA will  start working on the next archive.
  4384.  
  4385.          [desc]        This must  be a  short description of the type of
  4386.                        scanner. It will be displayed in the MTA log-file
  4387.                        and  remote  when  MTA is  doing its work under a
  4388.                        protocol  driver like FileDoor <tm>. It can be up
  4389.                        to 40 bytes  and  spaces  must  be substituded by
  4390.                        underscore characters ('_');
  4391.  
  4392.          [crt]         You must  either supply   'B' or  'D'. If     the
  4393.                        scanner is BIOS  oriented (line-mode) and  can be
  4394.                        run in the  MTA window, you  can use 'B'.  If the
  4395.                        scanner is using direct video calls/running  full
  4396.                        screen, you  must supply  'D'. MTA  will preserve
  4397.                        the screen according to this option;
  4398.  
  4399.          [swap]        This must  be the  amount of  memory (in  Kbytes)
  4400.                        that  must  be  available  to  run  the   scanner
  4401.                        without MTA having to swap itself out of  memory.
  4402.                        The  examples  in  the  supplied MTA.CTL are good
  4403.                        ones and used while testing;
  4404.  
  4405.          [lowe]        This must be the errorlevel the scanner   returns
  4406.                        when  a  virus  is  found.  Most scanners use the
  4407.                        errorlevel 1 when a virus is found, some of  them
  4408.                        use  a  range.  Check  the  documentation  of the
  4409.                        scanner to make sure you supply the right  level.
  4410.                        The  examples  in  MTA.CTL  are  correct  for the
  4411.                        given scanners;
  4412.  
  4413.          {highe}       This parameter is optional. If the scanner   will
  4414.                        return a  range of  errorlevels when  a virus  is
  4415.                        involved  (HTScan  does),  you  must  supply  the
  4416.                        lower limit  in [lowe]  and the  higher limit  in
  4417.                        {highe}.   If you  don't supply  {highe}, it will
  4418.                        be set  to the  same value  as [lowe].  The given
  4419.                        examples  in  MTA.CTL  are  correct for the given
  4420.                        scanners;
  4421.  
  4422.          [Path]        This parameter must contain the drive,  directory
  4423.                        and  filename  of  the  scanner  in question. MTA
  4424.                        will  validate  if  the  program  is at the given
  4425.                        location and give a warning if it isn't;
  4426.  
  4427.          [parm] {parm} At  this  location   you  can  (must) supply  the
  4428.                        various parameters for  the scanner. There  are a
  4429.                        few macros  available  that  will  be replaced by
  4430.                        values at run-time. These are:
  4431.                        %P This macro will be replaced with the full name
  4432.                           of the HIGHEST directory in the tree where the
  4433.                           decompressed files reside;
  4434.                        %F Will do the same but  will  show a \*.* behind
  4435.                           the directory;
  4436.                        %D This macro will be replaced with the LAST node
  4437.                           in the directory  tree.  For  example, if  the
  4438.                           directory is E:\TUP\TST\1F6566A6, %D  will  be
  4439.                           replaced by 1F6566A6. This comes in handy  for
  4440.                           scanners that make problems in networks;
  4441.                        %L This macro will be replaced by the driveletter
  4442.                           and a colon (C:, E: and so on). Some  scanners
  4443.                           can only work on drives and not on directories
  4444.                           only;
  4445.                        %S This is a better replacement for %L.  It  will
  4446.                           be subtituded with the driveletter (and colon)
  4447.                           of the SUBSTituted drive (only  when  you  use
  4448.                           the SUBST support,  which  is  advised).  Only
  4449.                           when the scanner has  problems  with  a  SUBST
  4450.                           drive you should use %L. If you don't use  the
  4451.                           SUBST support of MTA, %S will be replaced with
  4452.                           the normal drive (as with %L);
  4453.  
  4454.          Never forget to  check if the  scanner will halt  for a prompt.
  4455.          If this is the  case and you run  unattended, you could have  a
  4456.          problem. If you  run attended, this  makes no difference.  Most
  4457.          scanners implement  a type  of 'No-prompt'  mode, like /NOPAUSE
  4458.          with SCAN.  Be sure  to set  it somewhere  in [parm] or {parm}.
  4459.          Also do not forget to  implement the option to check  ALL lower
  4460.          trees  under  the  directory  that  is tested. The scanner must
  4461.          also scan all sub-directories.
  4462.  
  4463.          Examples for the mentioned  scanners are included (and  tested)
  4464.          in the example MTA.CTL in the distribution archive.
  4465.  
  4466.  Relate: VirusMasks
  4467.  Dest. : All
  4468.  
  4469.  
  4470.  ┌─────────────────────────────────────────────────────────────────────┐
  4471.  │ VirusMasks [mask1] {mask2}..{mask10}                                │
  4472.  └─────────────────────────────────────────────────────────────────────┘
  4473.  Usage : Normally when you supply one or  more VirusScanner options, MTA
  4474.          will ALWAYS call all  virus-scanners for every  archive that is
  4475.          converted. This can be a pain in the neck when you have lots of
  4476.          files that don't contain  files that can carry a virus. If this
  4477.          is the case, or you want  to limit the testing of viri for some
  4478.          other reason, you  can  supply this VirusMasks option. With the
  4479.          option you can  supply  1 to 10 different file-masks. If one or
  4480.          more of  these  file-masks  match files inside the archive that
  4481.          is converted, MTA  will  call the virus-scanners. If no file in
  4482.          the archive matches  any of the masks that you supply with this
  4483.          option, the virus-scanners are NOT called !
  4484.  
  4485.          [mask1]       This parameter must be a valid file-mask. You can
  4486.            \\          also use the DISP-compatible format (=value). You
  4487.          {mask10}      must supply at  least  one mask when you use this
  4488.                        option and  you  can supply to a maximum of 10 of
  4489.                        these masks. In  normal  situations you will only
  4490.                        supply  extensions  like (*.COM, *.EXE, *.OVR and
  4491.                        *.SYS)  but  it  IS  possible to trigger the scan
  4492.                        on a full file-mask (like AVIRUS.COM).
  4493.  
  4494.          When you do NOT supply this option but you have supplied one or
  4495.          more  VirusScanner  options, the scan is ALWAYS performed. Only
  4496.          when the VirusMasks option is present, the scan will be limited
  4497.          to those archives that contain one or more match !
  4498.  
  4499.  Relate: VirusScanner
  4500.  Dest. : All
  4501.  
  4502.  
  4503.  ┌─────────────────────────────────────────────────────────────────────┐
  4504.  │ EXITBeforeStart       {dynswapsiz} [path] {option}...{option}       │
  4505.  │ EXITBeforeEnd         {dynswapsiz} [path] {option}...{option}       │
  4506.  │ EXITBetweenConversion {dynswapsiz} [path] {option}...{option}       │
  4507.  │ EXITAfterCompression  {dynswapsiz} [path] {option}...{option}       │
  4508.  │ EXITBeforeFill        {dynswapsiz} [path] {option}...{option}       │
  4509.  │ EXITAfterFill         {dynswapsiz} [path] {option}...{option}       │
  4510.  └─────────────────────────────────────────────────────────────────────┘
  4511.  Usage : These options  include the  support for  various user exits  at
  4512.          various  places  in  MTA.  You   can  instruct  MTA  to call  a
  4513.          program OR a batch-file  (normally batch-files are not  allowed
  4514.          but  they  are  for   these  exits).   All  options  have these
  4515.          parameters in common:
  4516.  
  4517.          {dynswapsiz]} This  can  be  the  amount of memory (in  Kbytes)
  4518.                        that  must  be  available  to  run  the   scanner
  4519.                        without MTA having to swap itself out of  memory.
  4520.                        You  can  also  leave   out  the  parameter   (no
  4521.                        swapping);
  4522.  
  4523.          [Path]        This parameter must contain the drive,  directory
  4524.                        and filename  of the  exit in  question. MTA will
  4525.                        not validate  if they  are present  but will fail
  4526.                        the exit (but continue) if they are not. You  can
  4527.                        either supply a program or a batch-file.
  4528.  
  4529.          {option}      You can include various parameters that  will  be
  4530.                        passed  to  the  called  program/batch over here.
  4531.                        For some  options there  are special  macros (see
  4532.                        below) that can be used.
  4533.  
  4534.          Some of the exits can  contain macros inside the {option}  part
  4535.          of the call, these are:
  4536.  
  4537.          %1   This parameter can  occur anywhere in  {option}. MTA  will
  4538.               substitute  this  parameter  with  the relative path where
  4539.               the  uncompressed  files  are.  This  parameter is in fact
  4540.               superfluous, because  you ARE  in this  directory when the
  4541.               call  to   the  exit   is  made   (only  valid   for   the
  4542.               ExitBetweenConversion and ExitAfterCompression exits);
  4543.  
  4544.          %2   MTA will substitute this parameter with the name (not  the
  4545.               extension) of  the compressed  file (to  be) created (only
  4546.               valid     for      the      ExitBetweenConversion      and
  4547.               ExitAfterCompression exits);
  4548.  
  4549.          %3   MTA will  substitute this  parameter with  the   extension
  4550.               (without  the  point,  so  LZH   and  not  .LZH)  of   the
  4551.               compressed file (to be) created.  Can be used to test  the
  4552.               target  type  in  most  situations  (only  valid  for  the
  4553.               ExitBetweenConversion and ExitAfterCompression exits);
  4554.  
  4555.          %T   MTA will substitute this parameter with the number of  the
  4556.               MTA-task (see  /TASK) that  is running.  When no  /TASK is
  4557.               supplied, %T  will be  replaced by  1. This  macro can  be
  4558.               used to assign different exits for different tasks;
  4559.  
  4560.          You can take  a look into  the supplied example  of batch-files
  4561.          that are present inside the distribution archive.
  4562.  
  4563.          The various exits are called in the following phases:
  4564.  
  4565.          ExitBeforeStart              Called once, after reading     the
  4566.                                       MTA.CTL   file   and   before  the
  4567.                                       actual conversion. Can be used  to
  4568.                                       (re)set the cache  (if any) or  to
  4569.                                       sort directories and so on;
  4570.  
  4571.          ExitBeforeEnd                Called once, after the  conversion
  4572.                                       and  just  before  the termination
  4573.                                       of  MTA.  Can  be  used to reverse
  4574.                                       the actions in ExitBeforeStart  or
  4575.                                       anything else;
  4576.  
  4577.          ExitBetweenConversion        Called after every decompress  and
  4578.                                       before the  actual compress  takes
  4579.                                       place.  Can  be  used  to  perform
  4580.                                       special     actions     on     the
  4581.                                       decompressed files that MTA  can't
  4582.                                       do for you;
  4583.  
  4584.          ExitAfterCompression         Called after every final  compress
  4585.                                       of a file. Can be used to  perform
  4586.                                       actions  on  the  new archive that
  4587.                                       MTA can't do;
  4588.  
  4589.          ExitBeforeFill               Only called when /D is used.   Can
  4590.                                       be used to  do something with  the
  4591.                                       empty  diskette  that  is going to
  4592.                                       be filled  with files.  An example
  4593.                                       is to (re)format such a  diskette.
  4594.                                       Exit   is    called   for    every
  4595.                                       converted diskette;
  4596.  
  4597.          ExitAfterFill                Only called when /D is used.   Can
  4598.                                       be used to  do something with  the
  4599.                                       newly filled diskette. An  example
  4600.                                       is to catalogue  all files on  the
  4601.                                       diskette   with   your    favorite
  4602.                                       catalogue program. Exit is  called
  4603.                                       for every converted diskette;
  4604.  
  4605.          As said before, there  are some example batch-files  inside the
  4606.          distribution archive.
  4607.  
  4608.  Relate: All of MTA
  4609.  Dest. : Any
  4610.  
  4611.  
  4612.  
  4613.  3.3.8 Statements that are useful to Bulletin Board Systems and SysOps
  4614.  ───────────────────────────────────────────────────────────────────────
  4615.  MTA can  be useful  for normal  user and  also for  SysOp's of Bulletin
  4616.  Board Systems (BBS). There are  several options that involve the  daily
  4617.  operation of archives inside a BBS.
  4618.  
  4619.  ┌─────────────────────────────────────────────────────────────────────┐
  4620.  │ QBBSPaths [areafile] {ver}                                          │
  4621.  └─────────────────────────────────────────────────────────────────────┘
  4622.  Usage : If you change your file  areas once in a while, you can  decide
  4623.          to  use  another  source  for   MTA  than  the  usage  of   the
  4624.          DefaultPath option. If you  use the QBBSPaths option,  MTA will
  4625.          start the  conversion on  all directories  inside the area-file
  4626.          that you  assign. This  is only  useful when  you make usage of
  4627.          AMS  (the  MarkString/NoMarked  options)  or  the  OnlyNewFiles
  4628.          option.  The  QBBSPaths  option  is  meant for generic QuickBBS
  4629.          <tm> systems.
  4630.  
  4631.          [areafile]    This parameter must contain the drive,  directory
  4632.                        and  filename  of  the  QBBS  areafile.  MTA will
  4633.                        validate if it is  present. The file must  follow
  4634.                        the  standard  (transparent)  FLSEARCH.BBS   file
  4635.                        format for QuickBBS <tm> versions 2.74  and  less
  4636.                        supply {ver}  with  a value of 'OLD' or must be a
  4637.                        file of  the  FILECFG.DAT  type for versions 2.75
  4638.                        and higher;
  4639.  
  4640.          {ver}         Must be either  OLD  or NEW (OLD is the default).
  4641.                        OLD must  be  supplied   if  [areafile] points to a
  4642.                        FLSEARCH.CTL alike  file. NEW must be supplied if
  4643.                        [areafile] is  a  FILECFG.DAT  alike file that is
  4644.                        in use by QuickBBS <tm> from version 2.75 and up.
  4645.  
  4646.          MTA will work on ALL areas  that are supplied in this file.  If
  4647.          you  want  some  extra  areas,  then add some extra DefaultPath
  4648.          options to MTA.CTL. All  directories from the DefaultPath,  the
  4649.          QBBSPaths and the RAPaths options are merged together when they
  4650.          are supplied. Also the directories from MAXPaths are included !
  4651.          IF MTA can  detect  a  CDROM  area  (FILES.BBS and files are in
  4652.          different directries), it will ignore this directory unless you
  4653.          add it with a DefaultPath option !
  4654.  
  4655.  Relate: DefaultPath, RAPaths, MAXPaths
  4656.  Dest. : All
  4657.  
  4658.  
  4659.  ┌─────────────────────────────────────────────────────────────────────┐
  4660.  │ MAXPaths [areafile]                                                 │
  4661.  └─────────────────────────────────────────────────────────────────────┘
  4662.  Usage : If you change your file  areas once in a while, you can  decide
  4663.          to  use  another  source  for   MTA  than  the  usage  of   the
  4664.          DefaultPath option. If you  use the MAXPaths option,   MTA will
  4665.          start the  conversion on  all directories  inside the area-file
  4666.          that you  assign. This  is only  useful when  you make usage of
  4667.          AMS  (the  MarkString/NoMarked  options)  or  the  OnlyNewFiles
  4668.          option.  The  MAXPaths  option  is   meant for generic  MAXIMUS
  4669.          <tm> systems (based on MAXIMUS 2.xx and higher versions).
  4670.  
  4671.          [areafile]    This parameter must contain the drive,  directory
  4672.                        and filename of the  MAXIMUS  areafile.  MTA will
  4673.                        validate if it is  present. The file must  follow
  4674.                        the  standard  AREAS.DAT file for MAXIMUS 2.xx or
  4675.                        higher.
  4676.  
  4677.          MTA will work on ALL areas  that are supplied in this file.  If
  4678.          you  want  some  extra  areas,  then add some extra DefaultPath
  4679.          options to MTA.CTL. All  directories from the DefaultPath,  the
  4680.          QBBSPaths and the RAPaths options are merged together when they
  4681.          are supplied.
  4682.          IF MTA can  detect  a  CDROM  area  (FILES.BBS and files are in
  4683.          different directries), it will ignore this directory unless you
  4684.          add it with a DefaultPath option !
  4685.  
  4686.  Relate: DefaultPath, RAPaths, QBBSPaths
  4687.  Dest. : All
  4688.  
  4689.  
  4690.  ┌─────────────────────────────────────────────────────────────────────┐
  4691.  │ RAPaths [areafile] {RAver}                                          │
  4692.  └─────────────────────────────────────────────────────────────────────┘
  4693.  Usage : If you change your file  areas once in a while, you can  decide
  4694.          to  use  another  source  for   MTA  than  the  usage  of   the
  4695.          DefaultPath option.  If you  use the  RAPaths option,  MTA will
  4696.          start the  conversion on  all directories  inside the area-file
  4697.          that you  assign. This  is only  useful when  you make usage of
  4698.          AMS  (the  MarkString/NoMarked  options)  or  the  OnlyNewFiles
  4699.          option.  The  RAPaths  option  is  meant for Remote Access <tm>
  4700.          systems.
  4701.  
  4702.          [areafile]    This parameter must contain the drive,  directory
  4703.                        and  filename  of  the  RA  areafile.  MTA   will
  4704.                        validate if it is  present. The file must  follow
  4705.                        the standard (transparent) FILES.RA file format;
  4706.  
  4707.          {RAVer}       There are several formats of the FILES.RA   file,
  4708.                        depending on  the version  of Remote  Access <tm>
  4709.                        you use. If you  do not supply this  parameter, a
  4710.                        RA 1.1x is assumed.  If you run an  older version
  4711.                        of  RA,  you  must  supply  a '0'  for   versions
  4712.                        0.0x or a '1' for versions 1.0x. If  you  use the
  4713.                        special FILES.nnn (where nnn equals the FILEAREA)
  4714.                        files for CDRom  files  (only version 1.1x),  you
  4715.                        must supply a directory as  second  parameter and
  4716.                        not a '0' or '1'. In this case RA version 1.1x is
  4717.                        assumed and the directory you  supplied  will  be
  4718.                        used by MTA to  detect  file-area's that are on a
  4719.                        offline device. MTA will NOT work on these files.
  4720.  
  4721.  
  4722.          Examples: RA 0.0x    RAFILES C:\FILES.RA 0
  4723.                    RA 1.0x    RAFILES C:\FILES.RA 1
  4724.                    RA 1.1x    RAFILES C:\FILES.RA D:\FILES\
  4725.  
  4726.          MTA will work on ALL areas  that are supplied in this file.  If
  4727.          you  want  some  extra  areas,  then add some extra DefaultPath
  4728.          options to MTA.CTL. All  directories from the DefaultPath,  the
  4729.          QBBSPaths,MAXPaths and RAPaths options are merged together when
  4730.          they are supplied. IF MTA can detect the presence of a CDRom
  4731.          file-area (the FILES.BBS is in another location than the files)
  4732.          it will IGNORE such directory. If it must be included, you need
  4733.          to add a extra DefaultPath option !
  4734.  
  4735.  
  4736.  
  4737.  Relate: DefaultPath, QBBSPaths, MAXPaths
  4738.  Dest. : All
  4739.  
  4740.  
  4741.  ┌─────────────────────────────────────────────────────────────────────┐
  4742.  │ ExcludeDirectory [dir]                                              │
  4743.  └─────────────────────────────────────────────────────────────────────┘
  4744.  Usage : This option is mainly used when you want to exclude one or more
  4745.          (up to 255) directories from the directories that are collected
  4746.          by RAPaths, QBBSPaths and/or MAXPaths. If one or more of the
  4747.          directories inside in the BBS contain abnormal archives (other
  4748.          platforms), you can exclude such directory to overcome the
  4749.          problem that otherwise would occur when MTA starts converting
  4750.          these archives !
  4751.  
  4752.          [dir]         This value must point to a valid  drive/directory
  4753.                        which will be excluded from RAPaths, QBBSPaths or
  4754.                        MAXPaths (even from DefaultPath, but this has no
  4755.                        useful meaning).
  4756.  
  4757.  Relate: DefaultPath, QBBSPaths, MAXPaths, RAPaths
  4758.  Dest. : All
  4759.  
  4760.  ┌─────────────────────────────────────────────────────────────────────┐
  4761.  │ CarryComment [type] {comment}                                       │
  4762.  └─────────────────────────────────────────────────────────────────────┘
  4763.  Usage : This option is  another way of putting (useful)  comment inside
  4764.          the  target  archives.  There  are  various  in  which way this
  4765.          option can work, but only one is allowed. You can overrule  the
  4766.          type of work with the /CARCOM command-line option though.
  4767.  
  4768.          With CarryComment you order MTA to carry over any comment  from
  4769.          the source  archive (PAK/ZIP/ARJ/ZOO)  into the  target archive
  4770.          (same types). The carry can be done in three different ways.
  4771.  
  4772.          [type]        This  parameter can be set to 1, 2 or 3.  The way
  4773.                        CarryComment will work depends on the number  you
  4774.                        set  over  here.  The  values  have the following
  4775.                        meaning:
  4776.  
  4777.                        1 : MTA  will carry over  the comment (up  to 256
  4778.                            bytes) from the source file, if a comment  is
  4779.                            available;
  4780.  
  4781.                        2 : MTA will first look into the source file  and
  4782.                            will remember up to 256 bytes of the  comment
  4783.                            (if any).   After conversion,  MTA will  look
  4784.                            into the  file you  supplied in  the FilesBBS
  4785.                            option (if  you did  supply this  option). If
  4786.                            the file  has a  record inside  the FILES.BBS
  4787.                            (or alike  file), THIS  comment is  taken and
  4788.                            not the comment  in the source  file.  If  no
  4789.                            comment  is  available,  MTA  will  use   the
  4790.                            comment from the source file (if any);
  4791.  
  4792.                        3 : MTA will  always look into the  FILES.BBS (or
  4793.                            alike) file. This is only valid when you  use
  4794.                            the  FilesBBS   option.  If   a  record    is
  4795.                            available,  the  comment  is  carried over to
  4796.                            the target  file. If  no record  is available
  4797.                            the target will NOT have any comment;
  4798.  
  4799.          {comment}     When you supply this  parameter (spaces must   be
  4800.                        replaced  with  underscore  characters), MTA will
  4801.                        put this  comment IN  FRONT of  the comment  that
  4802.                        came from the carry itself. There will be a  CRLF
  4803.                        between this comment and the following  (carried)
  4804.                        comment.
  4805.  
  4806.          You can make a combination  of the AutoComment and the  current
  4807.          option (CarryComment). In  this case, MTA  will add a  combined
  4808.          into  the  target-file.  In  the  combination, the comment from
  4809.          AutoComment file  comes first  and the  comment constructed  by
  4810.          the  CarryComment  statement  comes  directly  (WITHOUT A CRLF)
  4811.          after this comment. Please keep  in mind that you separate  the
  4812.          two comments yourself (if needed) by adding a CRLF in the  file
  4813.          assigned by AutoComment.
  4814.  
  4815.          Please  also  read  the  info  on  the  FilesBBS option and the
  4816.          AddFilesBBS option.
  4817.  
  4818.  Relate: FilesBBS, AddFilesBBS
  4819.  Source: ZIP/PAK/ZOO/ARJ
  4820.  Dest. : ZIP/PAK/ZOO/ARJ
  4821.  
  4822.  
  4823.  ┌─────────────────────────────────────────────────────────────────────┐
  4824.  │ FILEIDDIZ {name1} {name2} {name3} {name4} {name5}                   │
  4825.  └─────────────────────────────────────────────────────────────────────┘
  4826.  Usage : For  some  BBS   programs,  the file FILE_ID.DIZ has a  special
  4827.          meaning.  It  contains  a  description  of the programs (files)
  4828.          that are included inside the  archive. MTA can do a  few things
  4829.          with  this  comment.  If  you  use this option (FILEIDDIZ), you
  4830.          instruct MTA to  store the text  from FILE_ID.DIZ into  memory.
  4831.          This  is  done, only  when  the  archive  actually  contains  a
  4832.          FILE_ID.DIZ file (or name-like, see parameters).
  4833.  
  4834.          You can also instruct MTA to search for other files that have
  4835.          the same usage as FILE_ID.DIZ. In some distribution nets, the
  4836.          author can create two files, one containing 'high' characters
  4837.          and one containing only characters in the range X'00'-X'127'.
  4838.          Other types of files will also be used for sure, so MTA is very
  4839.          'dynamic' in the usage of this option.
  4840.  
  4841.          {name1}       Normally MTA will  look for files with the   name
  4842.            //          FILE_ID.DIZ. If this is not the correct  standard
  4843.          {name5}       on  your  system,  MTA   can   look for (an)other
  4844.                        file(s) with such usage but  with different names.
  4845.                        MTA will  use  the  priority in the way you order
  4846.                        the different names. If you use A B C D and E for
  4847.                        {name1} to {name5} and the  archive contains both
  4848.                        B and D, MTA  will  use B and will leave D alone.
  4849.                        If you use A D C B and E, MTA will use the D-file
  4850.                        because it comes first in the list. There  can be
  4851.                        a maximum of 5 different names !
  4852.  
  4853.          Previous versions of MTA were not so relaxed when the format of
  4854.          the FILE_ID.DIZ was  tested. There  is  no  actual standard for
  4855.          this file, though the original distribution-net used files with
  4856.          8 lines, each containing  43  bytes of text (FILES.BBS format).
  4857.          MTA would give a warning when more (or less) lines were present
  4858.          and the lines exceeded the 43  byte bounds. Because of the more
  4859.          dynamic usage (not only  FILE_ID.DIZ can be used), MTA will now
  4860.          store up to 20 lines  of  (up to) 128 bytes of text without any
  4861.          warning.
  4862.  
  4863.          This option  (on its  own) will  not do  more than  reading the
  4864.          file FILE_ID.DIZ  (or the names you  supplied) and  storing the
  4865.          information  in  memory.  What  is  going  to  happen with this
  4866.          informations is  depending on  the FilesBBS/AddFILESBBS  option
  4867.          and/or the StoreComment and ReplaceComment option).
  4868.  
  4869.  
  4870.  Relate: FilesBBS/AddFilesBBS, StoreComment, ReplaceComment
  4871.  Source: All
  4872.  Dest. : All
  4873.  
  4874.  
  4875.  ┌─────────────────────────────────────────────────────────────────────┐
  4876.  │ LeadingSpace TRIM                                                   │
  4877.  │ LeadingSpace CHAR [char]                                            │
  4878.  └─────────────────────────────────────────────────────────────────────┘
  4879.  Usage : This  is  a very  special option that can be used when you work
  4880.          with special door-programs that list your FILES.BBS-alike files
  4881.          in a non-conventional way.
  4882.  
  4883.          When MTA  obtains  information  from the FILE_ID.DIZ (or alike)
  4884.          files  and  this  comments  contains spaces at the beginning of
  4885.          the second (or higher) line, like:
  4886.  
  4887.          This file description has a special format because
  4888.              - It contains spaces at the start of this line
  4889.              - And again
  4890.              - And again
  4891.  
  4892.          it will keep this spaces (by default), resulting in entries  in
  4893.          the FILES.BBS-alike file, that look like this:
  4894.  
  4895.          ffffffff.eee This file description has a special format because
  4896.           +    - It contains spaces at the start of this line
  4897.           +    - And again
  4898.           +    - And again
  4899.  
  4900.          Some  door-programs  that list  FILES.BBS-alike files with this
  4901.          format, will  display  these lines with a bad adjustment on the
  4902.          screen. To overcome  this  problem, you can use LEADINGSPACE to
  4903.          convert the descriptions.
  4904.  
  4905.          TRIM  :  When TRIM  is used, MTA  will strip all leading spaces
  4906.                   from the comment and will add the '+' before the first
  4907.                   non-space character;
  4908.  
  4909.          CHAR  :  When CHAR is used, MTA will replace all leading spaces
  4910.                   with the  character  [char]. [char] can  be coded as a
  4911.                   single  character (like 'Leadingspace #', resulting in
  4912.                   the replacement  of each leading space into '#') or as
  4913.                   a 3-digit  number (like 'Leadingspace 225',  resulting
  4914.                   in the  replacement  of  each leading  space into 'ß').
  4915.                   The number must be decimal !
  4916.  
  4917.  Relate: FILEIDDIZ, ADDFILESBBS
  4918.  Dest. : All
  4919.  
  4920.  
  4921.  ┌─────────────────────────────────────────────────────────────────────┐
  4922.  │ ReplaceComment                                                      │
  4923.  └─────────────────────────────────────────────────────────────────────┘
  4924.  Usage : When you use the FILEIDDIZ parameter, MTA can add new comments
  4925.          to FILES.BBS that come from this file (see FILEIDDIZ option).
  4926.          Normally, MTA will not REPLACE a comment in FILES.BBS with the
  4927.          comment taken from this file. This could cause much harm to all
  4928.          your FILES.BBS files when you (re)convert a complete area of
  4929.          files. All you modified comments would be removed when a file
  4930.          contains a FILE_ID.DIZ-alike file.
  4931.  
  4932.          If you want to replace existing comments in FILES.BBS with the
  4933.          comment that comes from a FILE_ID.DIZ-alike file that is  read
  4934.          when the file  in  question  is converted, you can supply this
  4935.          option but be  careful. For  starters,  MTA remove the comment
  4936.          somewhere in the  FILES.BBS  and  will  add the new comment to
  4937.          the end of the  FILES.BBS. Also,  carefully  created  comments
  4938.          with nice  bells  and  whistles are replaced by something that
  4939.          indeed covers the file-description but is always very simple !
  4940.  
  4941.  Relate: FilesBBS/AddFilesBBS, FILEIDDiz
  4942.  Source: All
  4943.  Dest. : All
  4944.  
  4945.  
  4946.  ┌─────────────────────────────────────────────────────────────────────┐
  4947.  │ DefFilesBBSDesc [mask] [desc]                                       │
  4948.  └─────────────────────────────────────────────────────────────────────┘
  4949.  Usage : When MTA has to add the converted file to the FILES.BBS (alike)
  4950.          file and there  is  NO  comment taken from ANY location (any of
  4951.          the FILE_ID.DIZ-alike files and/or previous FILES.BBS entries),
  4952.          MTA will  (by default)  add  'No description available' as  the
  4953.          comment  inside the  FILES.BBS-alike file. Previous versions of
  4954.          MTA would  even only  add the  filename (and no comment) to the
  4955.          FILES.BBS-alike file when the archive was NEW.
  4956.  
  4957.          MTA  will  now,  by default, put  'No description available' in
  4958.          the  FILES.BBS-alike file. This will be the case if NO previous
  4959.          description  is  available (FILE_ID.DIZ, FILES.BBS)  and/or the
  4960.          archive is NEW.
  4961.  
  4962.          BEFORE MTA  will  add 'No description available', MTA will scan
  4963.          all available DefFILESBBSDesc options in MTA.CTL. These options
  4964.          (up to 255 are allowed) have two parameters:
  4965.  
  4966.          [mask]        This must  be a valid DOS, 4Dos <tm> or DISP <tm>
  4967.                        filename  mask  (wildcards allowed). There are no
  4968.                        directories allowed;
  4969.  
  4970.          [desc]        This must  be the description that belongs to the
  4971.                        previous  [mask]. It  can  be  up to 47 byte long
  4972.                        and spaces are allowed.
  4973.  
  4974.          If MTA can  match  the filename with a mask, the comment of the
  4975.          FIRST match  is  carried  over  into  the FILES.BBS-alike file.
  4976.          You can also use  this option to change the default comment for
  4977.          ALL files.
  4978.  
  4979.          An example:
  4980.  
  4981.          DefFilesBBSDesc NODELIST.*   The new nodelist file
  4982.          DefFilesBBSDesc NODEDIFF.*   The new nodelist difference file
  4983.          DefFilesBBSDesc NODE*.*      Something to do with the nodelist
  4984.          DefFilesBBSDesc *.LU         ARRRG, who uses LU these days ?
  4985.          DefFilesBBSDesc *.*          No description found, sorry !
  4986.  
  4987.          The following files will give the following results:
  4988.  
  4989.          NODELIST.A26    Decription : The new nodelist file
  4990.          NODESHIT.A88                 Something to do with the nodelist
  4991.          NADASHIT.Z12                 No description found, sorry !
  4992.          BAR.LU                       ARRRG, who uses LU these days ?
  4993.          FOOBAR.ZOO                   No description found, sorry !
  4994.  
  4995.  Relate: FilesBBS/AddFilesBBS, FILEIDDiz, CarryComment
  4996.  Source: All
  4997.  
  4998.  
  4999.  ┌─────────────────────────────────────────────────────────────────────┐
  5000.  │ FilesBBS {location}                                                 │
  5001.  └─────────────────────────────────────────────────────────────────────┘
  5002.  Usage : If you convert files, the name will change in most cases  (from
  5003.          the source system, fi.  A.ZIP, to the destination,  fi. A.LZH).
  5004.          This change will  cause any entry  in the FILES.BBS  alike file
  5005.          to be  invalid. MTA  can help  out in  this case.  When you add
  5006.          this  option,  the  entries  in  the  FILES.BBS  alike file (if
  5007.          available) will also change !
  5008.  
  5009.          There are several  formats of this  option. If coded  without a
  5010.          parameter, MTA will  assume FILES.BBS as  the filename and  the
  5011.          directory where the conversion  takes place as the  location of
  5012.          the file.
  5013.  
  5014.          {location}    This parameter is optional an can either contain:
  5015.  
  5016.                        - A filename. In  this case MTA will  assume this
  5017.                          filename  as  the  name  of the FILES.BBS alike
  5018.                          file  and  the  directory  where the conversion
  5019.                          takes place as the location;
  5020.  
  5021.                        - A  full path,  containing drive,  directory and
  5022.                          filename. In  this case,  MTA will  assume that
  5023.                          you only  have ONE  FILES.BBS alike  file (this
  5024.                          is the case  for RBBS-alike systems).  The name
  5025.                          and location are assigned with this parameter.
  5026.  
  5027.          When you don't use  the FilesBBSFormat option (see  later), MTA
  5028.          will search  for filenames  in position  1 of  each record  and
  5029.          with the format FILENAME.EXT (upper- and lower case).   Changes
  5030.          are  made  after  every  conversion.   If  MTA  aborts  on   an
  5031.          operation,  all  PREVIOUS  archives  that  are  converted   ARE
  5032.          already changed in the FILES.BBS alike file(s).
  5033.  
  5034.          If you run  the ExitAfterCompression to  create SFX files  from
  5035.          the target  archives, the  change in  the FILES.BBS  alike file
  5036.          will  be   incorrect  !   You  must   use  one   of  the    MTA
  5037.          CompressionType values that instruct MTA to create the SFX.  In
  5038.          this case the change will be done correctly !
  5039.  
  5040.          It is also possible to change any sizes in the FILES.BBS  alike
  5041.          file(s). Some  of these  files contain  the actual  size of the
  5042.          file (RBBS master  directory). MTA will  change the size  also,
  5043.          if the correct size was already present in the FILES.BBS  alike
  5044.          file.
  5045.  
  5046.          If comments in the FILES.BBS  alike file start with a  download
  5047.          counter (e.g. FILENAME.EXT [01]  Downloaded once), and you  use
  5048.          the CarryComment  option (types  2 or  3), MTA  will strip  the
  5049.          download-counter  (only  when  the  format  is [nnnn]) from the
  5050.          description  that  will  be  added  to  the archive (not in the
  5051.          FILES.BBS alike file).
  5052.  
  5053.          This option  can also  be used  in a  NON-BBS environment where
  5054.          4Dos is installed and used. You should set the various  options
  5055.          as follows:
  5056.  
  5057.          - Set the FilesBBS option       to 'FilesBBS DESCRIPT.ION';
  5058.          - Set the FilesBBSFormat option to 'FilesBBSFormat 1 1 I2';
  5059.          - Set the AddFilesBBS option;
  5060.          - Set the CarryComment option to 2 (without extra parameters);
  5061.  
  5062.          In this case the comment will  be carried over out of the  4Dos
  5063.          DESCRIPT.ION file (this  is a hidden  file that 4DOS  maintains
  5064.          when you  use the  DESCRIBE command),  the change  of extension
  5065.          (if any) will be performed in the same file and if there is  no
  5066.          comment for this file in  the DESCRIPT.ION file, MTA can  carry
  5067.          over the comment from the archive (if any) into this file.
  5068.  
  5069.          When the FilesBBS option is active and MTA detects a  defective
  5070.          archive, MTA will move  this archive to the  supplied directory
  5071.          for  archives  in  error.  MTA  will also carry the description
  5072.          from the original FILES.BBS alike file over to a new  FILES.BBS
  5073.          alike file in this error directory.  The original comment  will
  5074.          ALSO  stay  in  the  original  FILES.BBS  alike  file. When the
  5075.          FILES.BBS alike  file is  on a  fixed location,  this option is
  5076.          not triggered.
  5077.  
  5078.  Relate: FilesBBSFormat
  5079.  Dest. : All
  5080.  
  5081.  
  5082.  ┌─────────────────────────────────────────────────────────────────────┐
  5083.  │ AddFilesBBS                                                         │
  5084.  └─────────────────────────────────────────────────────────────────────┘
  5085.  Usage : If you receive new  files without any entries in the  FILES.BBS
  5086.          alike file,  MTA can  add them  for you.  If the source archive
  5087.          also contains a  description (comment), this  is also added  to
  5088.          that file. The AddFilesBBS  option will ONLY function  when you
  5089.          have  set  the  FilesBBS  option.  The description will only be
  5090.          added (if present) when the  CarryComment option is set with  a
  5091.          value of 1 or 2. The format of the added record is the same  as
  5092.          set in the FilesBBSFormat option.
  5093.  
  5094.          If you have set the FILEIDDIZ option AND there is such a file
  5095.          inside the archive, MTA will use THIS comment (it has a higher
  5096.          priority than CarryComment) for the new entry in the FILES.BBS
  5097.          alike file. If there already IS a comment in the FILES.BBS
  5098.          alike file (for this file), MTA will NOT overwrite that comment
  5099.          with the new comment.
  5100.  
  5101.          If MTA  is unable to obtain comments from the FILEIDDIZ option,
  5102.          it will also search in any DESCRIPT.ION file (4Dos <tm> comment
  5103.          file) or in  any ?????????.I?? (FileDoor <tm> information file)
  5104.          file before searching in the DefFilesBBSDesc options !
  5105.  
  5106.  Relate: FilesBBSFormat, FilesBBS, CarryComment, FileIDDiz,
  5107.          DefFilesBBSDesc
  5108.  Dest. : All
  5109.  
  5110.  
  5111.  ┌─────────────────────────────────────────────────────────────────────┐
  5112.  │ FilesBBSFormat [name] [extension] [comment]                         │
  5113.  └─────────────────────────────────────────────────────────────────────┘
  5114.  Usage : This option will instruct MTA about the internal format of  the
  5115.          FILES.BBS alike  file.   Under default  conditions, MTA expects
  5116.          the  filename  to  start  on  position  1  of each line, with a
  5117.          filename format  for name.ext  (with a  point between  the name
  5118.          and the  extension) and  the comment  to start  on position 14.
  5119.          When your FILES.BBS alike file  (if you use any) is  different,
  5120.          you must use this option to set the new format.
  5121.  
  5122.          [name]        This parameter must be set to the position  where
  5123.                        the filename will start;
  5124.  
  5125.          [extension]   This parameter must be set to the position  where
  5126.                        the  extension  will  start.  If filename and the
  5127.                        extension  are  combined  together  with a point,
  5128.                        [name] and [extension] must be the same value;
  5129.  
  5130.          [comment]     This parameter must be the starting point of  the
  5131.                        comment.  If  the  FILES.BBS  alike file does not
  5132.                        contain a comment,  you must set  it to 255.   If
  5133.                        the comment 'floats'  somewhere in the  file, the
  5134.                        starting position  is different  every time,  you
  5135.                        can use another format.  In this case you  supply
  5136.                        the ITEM NUMBER  (and not the  starting position)
  5137.                        with the value 'I'. For example:
  5138.  
  5139.                        My.ZIP 1234 The comment
  5140.                        Our.ZIP 233222 The comment
  5141.  
  5142.                        In  this  case,  the  comment  is floating but is
  5143.                        always the 4th item.  In this case you  supply I4
  5144.                        for this parameter.
  5145.  
  5146.          The FilesBBSFormat option only has a meaning when the  FilesBBS
  5147.          option is also set.
  5148.  
  5149.  Relate: FilesBBS
  5150.  Dest. : All
  5151.  
  5152.  
  5153.  ┌─────────────────────────────────────────────────────────────────────┐
  5154.  │ FilesCounter [location] {startchar} {endchar}                       │
  5155.  └─────────────────────────────────────────────────────────────────────┘
  5156.  Usage : This  option  can  be used to instruct MTA how to recognize and
  5157.          use files-counters  in  the  FILES.BBS-alike file. MTA will use
  5158.          the information  to  strip files-counter from descriptions that
  5159.          are added as  comment  to the archive (CARRYCOMMENT option) and
  5160.          to add  files-counters  when  the  filenames are changed in the
  5161.          FILES.BBS-alike  files or  files are added to this file (if the
  5162.          ADDFILESBBS option is set).
  5163.  
  5164.          [location]    This is the  location of the files-counter in the
  5165.                        FILES.BBS-alike file. Valid values are:
  5166.  
  5167.                        NONE  : There  are  NO  files-counters set in the
  5168.                                FILES.BBS-alike  files (you don't use any
  5169.                                counters);
  5170.  
  5171.                        START : The  files-counters  are  placed  at  the
  5172.                                start of the comment;
  5173.  
  5174.                        END   : The files-counters  are placed at the end
  5175.                                of the comment;
  5176.  
  5177.          {startchar}   This  parameter  can  be  used to  tell MTA which
  5178.                        character  is  used as the starting character for
  5179.                        the files-counter (like '[', '{', '(' and so on).
  5180.                        By default MTA  assumes  the '[' character as the
  5181.                        start-character of the files-counter;
  5182.  
  5183.          {endchar}     This  parameter  can  be  used  to tell MTA which
  5184.                        character is used as the ending character for the
  5185.                        files-counter (like ']', '}', ')' and  so on). By
  5186.                        default MTA assumes the ']' character as the end-
  5187.                        character of the files-counter;
  5188.  
  5189.  
  5190.          When no FILESCOUNTER option is supplied, MTA will assume:
  5191.  
  5192.          FilesCounter START [ ]
  5193.  
  5194.          E.g. counters  at  the  start of the comment, starting with '['
  5195.          and ending with ']'. FILES.BBS-alike entries will look like:
  5196.  
  5197.          nnnnnnnn.eee [##] ccccccccccccccccccccccccccccccccccccccccc
  5198.  
  5199.          When you do not use any counters in your FILES.BBS-alike files,
  5200.          you have to set:
  5201.  
  5202.          FilesCounter NONE
  5203.  
  5204.  Relate: FilesBBS, AddFilesBBS, CarryComment
  5205.  Dest. : All
  5206.  
  5207.  
  5208.  ┌─────────────────────────────────────────────────────────────────────┐
  5209.  │ TICKFiles [mask]                                                    │
  5210.  │ FESFiles  [mask]                                                    │
  5211.  └─────────────────────────────────────────────────────────────────────┘
  5212.  Usage  :  Until  now,  all  previous  BBS-options had to do with normal
  5213.          FILES.BBS alike type of  files. The following options  do some-
  5214.          thing  with  other  types  of  files.   These  options makes it
  5215.          possible to pick  up the description  of a certain  file from a
  5216.          TICK or  FES file.  When you  get your  files into  the inbound
  5217.          directory and the *.TIC/FES files along with them, you can  now
  5218.          convert them (and  optionally move them)  to any other  system,
  5219.          while MTA will try to extract the comment of the file from  the
  5220.          associated TICK/FES-file. You can  do two types of  things with
  5221.          these  comments.  You  can  add  them  to  the  FILES.BBS   (if
  5222.          AddFILESBBS is set to on) AND you can store them in the  header
  5223.          of the archive (comment) when CarryComment is set to on.
  5224.  
  5225.          If CarryComment is on (independent  of the type 1,2 or  3), MTA
  5226.          will  search  for  the  comment  in the old archive-header, the
  5227.          FILES.BBS or  both. If  TICKFiles is  set   AND MTA  can find a
  5228.          description in any of the TICK-files, this comment will  always
  5229.          overrule the comment from the FILES.BBS or the old header.  The
  5230.          same goes for the FESFiles option.
  5231.  
  5232.          [mask]        This parameter must point to a drive,   directory
  5233.                        and  filemask.   Most  obvious   is  to   include
  5234.                        *.TIC as   the  filemask   (and  in   some  cases
  5235.                        *.BAD can also be handy).
  5236.  
  5237.          You  can  use  multiple  TICKFiles  options to assign different
  5238.          TICK files (*.TIC and *.BAD) and in different directories.   Up
  5239.          to  10  are  allowed.  Also  10  FESFiles  options  are allowed
  5240.          (*.FES, *.BAD).
  5241.  
  5242.          The  TICK/FES-files  are  ALL  searched  (for  every  converted
  5243.          archive) until either:
  5244.  
  5245.          - a description is found;
  5246.  
  5247.          - all files are processed and no description was found;
  5248.  
  5249.          MTA will  search for  either FILE:  or FILE  and DESC: and DESC
  5250.          inside the TICK-files. This is  pointed out in FSC-0028 !   The
  5251.          FES files follow the authors description !
  5252.  
  5253.  Relate: FilesBBS, AddFilesBBS, CarryComment
  5254.  Dest. : All
  5255.  
  5256.  
  5257.  ┌─────────────────────────────────────────────────────────────────────┐
  5258.  │ UpdateUntypedFiles [mask]                                           │
  5259.  └─────────────────────────────────────────────────────────────────────┘
  5260.  Usage : This is  a special, independent, option  to update any type  of
  5261.          file with the new (converted) name of the archive. Let us  take
  5262.          an example:
  5263.  
  5264.          -) Some  products keeps  a small  database with  names of files
  5265.             (also your archives) inside.   RFW is such an example.   Now
  5266.             you  convert  some  archive  and  the information inside the
  5267.             database has  become invalid  !   UpdateUntypedFiles is  the
  5268.             answer to your problem.
  5269.  
  5270.          UpdateUntypedFiles will update ANY type of file (even a program
  5271.          or binary file) with the new name of the archive IF:
  5272.  
  5273.          - You don't use the /D option;
  5274.  
  5275.          - The name  of the target  has the same  length as the  name of
  5276.            the source. A  conversion from something.ZIP  to Something.MD
  5277.            will not be performed;
  5278.  
  5279.          - The name location is  within the 64K (65535) bytes  bounds of
  5280.            the file;  Longer files  will NOT  be truncated  but only the
  5281.            first 64K of bytes are scanned and (optionally) changed;
  5282.  
  5283.          [mask]        This parameter must point to a drive,   directory
  5284.                        and filemask.
  5285.  
  5286.          You can add up to  10 UpdateUntypedFiles options into the  file
  5287.          MTA.CTL. But be smart and think before you do. MTA will  search
  5288.          ALL files and though  this is fast I/O,  it can take some  time
  5289.          if you include numerous files !
  5290.  
  5291.          UpdateUntypedFiles can be used  as a replacement to  the update
  5292.          of the  FILES.BBS alike  file(s) when  these files  are smaller
  5293.          than 64K.  In that  case, this  option will  give you a 50-200%
  5294.          gain in speed over the FilesBBS option !!.
  5295.  
  5296.  Relate: UpdateTICKFiles, UpdateFESFiles
  5297.  Dest. : All
  5298.  
  5299.  
  5300.  ┌─────────────────────────────────────────────────────────────────────┐
  5301.  │ UpdateUntypedFull                                                   │
  5302.  └─────────────────────────────────────────────────────────────────────┘
  5303.  Usage : This option can be used in combination with the previous option
  5304.          (UPDATEUNTYPEDFILES). If  this  option  is  set, MTA  will only
  5305.          change the filename  in  the  'untyped file'  when both the old
  5306.          filename AND the name of the directory both match the converted
  5307.          file.
  5308.  
  5309.          Without this option, MTA will only change the file when the old
  5310.          old filename matches but MTA won't look at the directoryname.
  5311.  
  5312.          You should  set  this option when you use UPDATEUNTYPEDFILES to
  5313.          update *.MSG files with attached files (TICK/FES support) !
  5314.  
  5315.  Relate: UpdateUntypedFiles
  5316.  Dest. : All
  5317.  
  5318.  
  5319.  ┌─────────────────────────────────────────────────────────────────────┐
  5320.  │ UpdateTICKFiles [mask]                                              │
  5321.  │ UpdateFESFiles  [mask]                                              │
  5322.  └─────────────────────────────────────────────────────────────────────┘
  5323.  Usage : The syntax  is the  same as  with UpdateUntypedfiles.  See  the
  5324.          chapter  about  TICK  files,  later  in this documentation. The
  5325.          material is to complex to put over here.
  5326.  
  5327.  Relate: UpdateUntypedFiles, UpdateMSGFiles
  5328.  Dest. : All
  5329.  
  5330.  
  5331.  ┌─────────────────────────────────────────────────────────────────────┐
  5332.  │ UpdateMSGFiles [dir]                                                │
  5333.  └─────────────────────────────────────────────────────────────────────┘
  5334.  Usage : The UPDATEMSGFILES option has a different format than the three
  5335.          previous options. There can be ut to 255 of these options with
  5336.          the following parameter:
  5337.  
  5338.          [dir]         This parameter must point to a ddirectory where
  5339.                        your *.MSG files are. Do not code the file-mask,
  5340.                        but ONLY the directory.
  5341.  
  5342.          See the chapter on TICK files for a description of this option.
  5343.  
  5344.  Relate: UpdateTICKFiles, UpdateFESFiles
  5345.  Dest. : All
  5346.  
  5347.  
  5348.  ┌─────────────────────────────────────────────────────────────────────┐
  5349.  │ UpdateMSGFull                                                       │
  5350.  └─────────────────────────────────────────────────────────────────────┘
  5351.  Usage : Same as the UPDATEUNTYPEDFULL  option  but now in relation with
  5352.          the UPDATEMSGFILES option.
  5353.  
  5354.          You  should  set  this  option  when  you use UPDATEMSGFILES to
  5355.          update *.MSG files with attached files (TICK/FES support) !
  5356.  
  5357.  Relate: UpdateMSGFiles
  5358.  Dest. : All
  5359.  
  5360.  
  5361.  ┌─────────────────────────────────────────────────────────────────────┐
  5362.  │ COMPort [port]                                                      │
  5363.  └─────────────────────────────────────────────────────────────────────┘
  5364.  Usage : MTA has internal modem support. This is needed in case you  run
  5365.          MTA as an exit of the  BBS (e.g. a protocol driver like  DISP's
  5366.          FileDoor). When you  use modem support,  MTA will echo  some of
  5367.          the progress to the COM-port and the user can follow a part  of
  5368.          the  conversion.  All  modem  related  options  will do NOTHING
  5369.          unless the Remote option or the /REMOTE command-line  parameter
  5370.          is used.
  5371.  
  5372.          [port]        This parameter must  point to the COM-port  that
  5373.                        MTA will use. If set to 0, no remote tracking  is
  5374.                        done.
  5375.  
  5376.  Relate: BaudRate, Remote, FossilPort /REMOTE
  5377.  Dest. : All
  5378.  
  5379.  
  5380.  ┌─────────────────────────────────────────────────────────────────────┐
  5381.  │ FOSSILPort [port]                                                   │
  5382.  └─────────────────────────────────────────────────────────────────────┘
  5383.  Usage : This  option  can   be  used  as a replacement for  the COMPort
  5384.          option. The major difference is  that [port] will now point  to
  5385.          the FOSSIL port number (usually 1 less than the COM-port).
  5386.  
  5387.  Relate: BaudRate, Remote, COMPort /REMOTE
  5388.  Dest. : All
  5389.  
  5390.  
  5391.  ┌─────────────────────────────────────────────────────────────────────┐
  5392.  │ BAUDRate [baud]                                                     │
  5393.  └─────────────────────────────────────────────────────────────────────┘
  5394.  Usage : When  remote tracking is  used, MTA must  know the baudrate  of
  5395.          the MTA-to-Modem speed.
  5396.  
  5397.          [baud]        This parameter must be set to the connect  speed.
  5398.                        If you  use a  locked modem,  you must  set it to
  5399.                        the locked  speed and  not to  the connect speed.
  5400.                        If set to 0, remote tracking is disabled.
  5401.  
  5402.          Normally you use  the /BAUD command-line  parameter to set  the
  5403.          baud-rate because it can vary, unless a locked speed is used.
  5404.  
  5405.  Relate: COMPort or FOSSILPort, Remote, /REMOTE
  5406.  Dest. : All
  5407.  
  5408.  
  5409.  ┌─────────────────────────────────────────────────────────────────────┐
  5410.  │ StoreSize {ext}                                                     │
  5411.  └─────────────────────────────────────────────────────────────────────┘
  5412.  Usage : This option, on its   own, does nothing, but it will be  useful
  5413.          when  remote  tracking  is  active.  In  this case it will do a
  5414.          function  that  is  specific  to  FileDoor.  If  this option is
  5415.          active and  MTA is  running under  FileDoor, MTA  will create a
  5416.          special file  with a  specific format.  This file  contains the
  5417.          ACTUAL size of  the file BEFORE  the conversion. FileDoor  will
  5418.          detect this file and will credit the user for the actual  bytes
  5419.          that were uploaded and not  the newly created number of  bytes.
  5420.          For example the user uploads  A.ARC (10000 bytes) and MTA  will
  5421.          convert it to A.ZIP  (6000 bytes). Without StoreSize,  FileDoor
  5422.          will credit  the user  for 6000  bytes but  with StoreSize set,
  5423.          FileDoor will take the actual 10000 bytes as credit.
  5424.  
  5425.          {ext}  Normally, MTA will create a file with the name equal  to
  5426.                 the archive (without  extension) and the  extension XS1.
  5427.                 This extension can only be used in FileDoor  3.01+.  All
  5428.                 earlier versions (up to 3.01Γ5)  use  the  extension F$D.
  5429.                 When you run FileDoor 2.03 (up to 3.01Γ5) or a  clone of
  5430.                 FileDoor  that  uses this system, you  must change {ext}  to
  5431.                 the proper extension (F$D in case of FileDoor 2.03);
  5432.  
  5433.          Even if you don't run remote, you can still use this option. In
  5434.          this case, it is up to you (or a batch oriented program) to  do
  5435.          something with the created file(s).
  5436.  
  5437.  Relate: Remote
  5438.  Dest. : All
  5439.  
  5440.  
  5441.  ┌─────────────────────────────────────────────────────────────────────┐
  5442.  │ StoreName {nam}                                                     │
  5443.  └─────────────────────────────────────────────────────────────────────┘
  5444.  Usage : This option, on its   own, does nothing, but it will be  useful
  5445.          when  remote  tracking  is  active.  In  this case it will do a
  5446.          function  that  is  specific  to  FileDoor.  If  this option is
  5447.          active and  MTA is  running under  FileDoor, MTA  will create a
  5448.          special file  with a  specific format.  This file  contains the
  5449.          name of the archives before and after the  conversion. FileDoor
  5450.          will detect this file and will use it to see any altered  names
  5451.          AFTER the upload.
  5452.  
  5453.          {nam}  Normally, MTA will create a file with the name equal  to
  5454.                 FileDoor.XS2. This filename can only be used in FileDoor
  5455.                 versions 3.01 (3.01Γ6 up to release). Only  beta-testers
  5456.                 and users  of FileDoor <tm> clones will  have  to  alter
  5457.                 {name} to something different (FILEDOOR.F#D  for gamma's
  5458.                 up to 3.01Γ5.
  5459.  
  5460.          Even if you don't run remote, you can still use this option. In
  5461.          this case, it is up to you (or a batch oriented program) to  do
  5462.          something with the created file(s).
  5463.  
  5464.  Relate: Remote
  5465.  Dest. : All
  5466.  
  5467.  
  5468.  ┌─────────────────────────────────────────────────────────────────────┐
  5469.  │ StoreComment {ext}                                                  │
  5470.  └─────────────────────────────────────────────────────────────────────┘
  5471.  Usage : This option, on its   own, does nothing, but it will be  useful
  5472.          when  remote  tracking  is  active.  In  this case it will do a
  5473.          function  that  is  specific  to  FileDoor.  If  this option is
  5474.          active and  MTA is  running under  FileDoor, MTA  will create a
  5475.          special file  with a  specific format.  This file  contains the
  5476.          comment (from CarryComment or FileIDDIZ) for the specific  file
  5477.          that was uploaded by the user.
  5478.  
  5479.          {nam}  Normally, MTA will create a file with the name equal  to
  5480.                 FILEDOOR.XS3. This  name can  only be  used in  FileDoor
  5481.                 3.01+ (up from FileDoor 3.01Γ6). If you use  a  FileDoor
  5482.                 clone you will have to  alter {nam}  to  the  name  this
  5483.                 program uses;
  5484.  
  5485.          Even if you don't run remote, you can still use this option. In
  5486.          this case, it is up to you (or a batch oriented program) to  do
  5487.          something with the created file(s).
  5488.  
  5489.  Relate: Remote
  5490.  Dest. : All
  5491.  
  5492.  
  5493.  ┌─────────────────────────────────────────────────────────────────────┐
  5494.  │ Remote                                                              │
  5495.  └─────────────────────────────────────────────────────────────────────┘
  5496.  Usage : When set (and  when both COMPort and Baudrate  contain non-zero
  5497.          values), MTA will do remote tracking and will send messages  to
  5498.          the remote user.
  5499.  
  5500.  Relate: Baudrate,FOSSILPort,COMPort,StoreSize,StoreName,StoreComment
  5501.  Dest. : All
  5502.  
  5503.  
  5504.  ┌─────────────────────────────────────────────────────────────────────┐
  5505.  │ RemoteColor [txtlow] [txthig] [ok] [err] [act] [fil]                │
  5506.  └─────────────────────────────────────────────────────────────────────┘
  5507.  Usage : This  option can be  used to overrule  the default colors  that
  5508.          MTA uses for remote messages.
  5509.  
  5510.          [...]         There are 6 types of colors that can be   changed
  5511.                        to your own  needs. You must  supply ALL of  them
  5512.                        when  you  use  this  option.  [...] can have the
  5513.                        following values:
  5514.  
  5515.                        0  : Black            8  : DarkGray
  5516.                        1  : Blue             9  : LightBlue
  5517.                        2  : Green            10 : LightGreen
  5518.                        3  : Cyan             11 : LightCyan
  5519.                        4  : Red              12 : LightRed
  5520.                        5  : Magenta          13 : LightMagenta
  5521.                        6  : Brown            14 : Yellow
  5522.                        7  : LightGray        15 : White
  5523.  
  5524.                        You must supply  a value that  is made up  by the
  5525.                        foreground-color  and  background-color  with the
  5526.                        following formula:
  5527.  
  5528.                        Color = [Foreground] + 16 * [Background]
  5529.  
  5530.                        Only the values 0 to 7 can be used for the  back-
  5531.                        ground color. Also you  can add 128 to  the total
  5532.                        to force a blinking value !
  5533.  
  5534.                        [txtLow] This  is  the  low intensity text  color
  5535.                                 (common text). Default value is 3;
  5536.  
  5537.                        [txtHig] This  is the  high intensity  text color
  5538.                                 (common text). Default value is 11;
  5539.  
  5540.                        [Ok]     This is  the color to  display  ok-text.
  5541.                                 Default value is 10;
  5542.  
  5543.                        [Err]    This  is the  color to  display  errors.
  5544.                                 Default value is 12;
  5545.  
  5546.                        [Act]    This  is the  color to  display  special
  5547.                                 activity. Default value is 13;
  5548.  
  5549.                        [Fil]    This  is the  color to  display   files.
  5550.                                 Default value is 14;
  5551.  
  5552.          Local colors can  not be changed  (yet). Colors are  only shown
  5553.          when ANSI-support is used (so /ANS0 is not used).
  5554.  
  5555.  Relate: Remote
  5556.  Dest. : All
  5557.  
  5558.  
  5559.  3.3.9 Special statements
  5560.  ───────────────────────────────────────────────────────────────────────
  5561.  The following statements  are a collection  of statements that  can not
  5562.  be categorized in one of the other groups.
  5563.  
  5564.  ┌─────────────────────────────────────────────────────────────────────┐
  5565.  │ IncludeCtl [path]                                                   │
  5566.  └─────────────────────────────────────────────────────────────────────┘
  5567.  Usage : This parameter is optional. In MTA.CTL you can include one  (or
  5568.          several) other CTL-files. This comes in handy when you want  to
  5569.          separate  your  'normal'  run-time  options  and  the 'special'
  5570.          options you change much.
  5571.  
  5572.          MTA  can  handle  nested  IncludeCTL  statements.  So  you  can
  5573.          include 'IncludeCTL MTA.001' in your MTA.CTL and again you  can
  5574.          include  'IncludeCTL  MTA.002'  in  your  MTA.001.   The  total
  5575.          number of IncludeCTL options  (nested and in the  primary file)
  5576.          can be up to 16.
  5577.  
  5578.          [path]        This parameter must  point to the    control-file
  5579.                        you want to  include. The parameter  must contain
  5580.                        the drive, directory and filename.
  5581.  
  5582.  Relate: None
  5583.  Dest. : All
  5584.  
  5585.  
  5586.  3.3.10 Statements available when using a registered version
  5587.  ───────────────────────────────────────────────────────────────────────
  5588.  The following statements can  be used to define  one or more exits.  An
  5589.  exit a sort  of hook in  the MTA execution  process. The several  exits
  5590.  (hooks) are called at special places  while MTA is executing on one  or
  5591.  more files.  The user  can 'hook  into' the  process when  one or  more
  5592.  exits are defined in MTA.CTL.
  5593.  
  5594.  ┌─────────────────────────────────────────────────────────────────────┐
  5595.  │ RegistrationName [name]                                             │
  5596.  └─────────────────────────────────────────────────────────────────────┘
  5597.  Usage : This option  has only a meaning  when you received a  key after
  5598.          you registered MTA.  In ANY OTHER  case (non registered  usage)
  5599.          you must NOT include this option.
  5600.  
  5601.  Relate: None
  5602.  Dest. : All
  5603.  
  5604.  
  5605.  
  5606.  3.4 Diskette option
  5607.  ───────────────────────────────────────────────────────────────────────
  5608.  One of  the benefits  of MTA  is its  power to  convert diskettes  with
  5609.  great ease. This  method is only  functioning properly when  you have a
  5610.  PC with both floppy (FDU) and hard-disk (HDU).
  5611.  
  5612.  Most  users  with  hard-disks  will   have  a  collection  of   archive
  5613.  diskettes,  containing  their  (less)  used  software. When new archive
  5614.  systems are released  (or newer versions),  conversion of the  complete
  5615.  collection is sometimes needed (or wanted).
  5616.  
  5617.  You must activate MTA's diskette option with the /D switch. If you  do,
  5618.  MTA will start a conversion  cycle that can be interrupted  by pressing
  5619.  [ESC] when the next  diskette is finished. It  can be repeated for  the
  5620.  next diskette  when you  insert this  diskette into  the drive and when
  5621.  you press [ENTER].
  5622.  
  5623.  Which steps does MTA take to convert a diskette:
  5624.  
  5625.  - MTA  will read  all files  (the ones  matching the wildcard, normally
  5626.    you use the *.*  wildcard to select them  all) and will detect  which
  5627.    files are archives or not;
  5628.  
  5629.  - MTA will move (copy + delete) the archives to the directory that  you
  5630.    assigned  to  the  FDUTempPath  option.  If  you  also  supplied  the
  5631.    AllDisketteFiles option, MTA will also move all non-archive files  to
  5632.    that directory;
  5633.  
  5634.  - MTA  will convert  all archives  inside the  FDUTempPath directory to
  5635.    the new system or the higher release;
  5636.  
  5637.  - The exit ExitBeforeFill is called,  so you can do something with  the
  5638.    (empty if AllDisketteFiles was set) diskette (like a reformat);
  5639.  
  5640.  - Now  MTA will  sort the  converted (and  non-archive) files  based on
  5641.    size.  It  will  start  a  copy  for  each file, from the FDUTempPath
  5642.    directory (back) to  the diskette until  one of the  following events
  5643.    happens:
  5644.  
  5645.    - The diskette is full before the  last file is copied.  This can  be
  5646.      the  case  when  the  target  system  has  created  bigger files (a
  5647.      negative reduction); - The files are all moved;
  5648.  
  5649.    Depending on the type of event above, MTA will do the following:
  5650.  
  5651.    - When there are still files  left to copy back, MTA will  move these
  5652.      files to the directory you assigned in the FDUTrashPath option;
  5653.  
  5654.    - When all  files were moved  back to the  diskette and the  diskette
  5655.      still contains free space (you  had a positive reduction on  one or
  5656.      more archives), MTA  will look if  there is/are (a)  file(s) in the
  5657.      FDUTrashPath directory  that fit  on the  diskette. If  so, it will
  5658.      copy this(these) file(s) until the diskette is full or until  there
  5659.      are  no  files  left  that  will  fit  into  the  free space on the
  5660.      diskette;
  5661.  
  5662.  - MTA will now execute the ExitAfterFill EXIT if set;
  5663.  
  5664.  - MTA will ask for next diskette (or you press [ESC] to terminate);
  5665.  
  5666.  Please notice  that it  is possible  that MTA  leaves some files inside
  5667.  the FDUTrashPath  directory after  it has  finished. If  the number  of
  5668.  files  is  getting  to  big  (or  there  are  no more diskettes left to
  5669.  convert), insert an empty diskette in  the FDU and run MTA with  the /D
  5670.  option. Because  there are  no files  to convert,  MTA will  move files
  5671.  from the FDUTrashPath directory to this empty diskette. You can  repeat
  5672.  this  until  the  lower  threshold  is  reached  or until all files are
  5673.  moved.
  5674.  
  5675.  One final  word. As  you have  noticed (I  hope) you  can add unlimited
  5676.  power to  MTA's diskette  option with  the 'Before'  and 'After' exits.
  5677.  These  can  be  used  to  reformat  the diskette or something else (the
  5678.  'Before'  exit)  and/or  to  re-catalog  your  diskette  when you use a
  5679.  disk-catalog program (the 'After' exit).
  5680.  
  5681.  
  5682.  
  5683.  3.5 KeyBoard control
  5684.  ───────────────────────────────────────────────────────────────────────
  5685.  When MTA is executing you have control over some keyboard functions.
  5686.  
  5687.  When you  press [ESC]  (escape button),  MTA will  terminate AFTER  the
  5688.  current files is converted. When you  did hit [ESC] but you would  like
  5689.  to continue after all, you can do  so by hitting any other key.   Using
  5690.  the [ESC] key is not available  when you execute MTA with the  diskette
  5691.  option (/D).
  5692.  
  5693.  When you press [S], MTA will  start a DOS-shell, the moment it  is save
  5694.  to do so. This can be anywhere in the conversion phase. MTA will  place
  5695.  you in the  directory you started  MTA from. NEVER  alter files in  the
  5696.  temporary directory MTA  has created if  you do not  know what you  are
  5697.  doing. Also pressing  any other key  after [S], releases  the DOS-shell
  5698.  option as with [ESC].
  5699.  
  5700.  Pressing [T]  will cause  MTA to  toggle the  statistical display  from
  5701.  static  to  dynamic  mode  or  the  other  way around, depending on the
  5702.  default settings  (AltDisplay option).  You can  toggle as  much as you
  5703.  like while MTA is running. If you  run in a special text mode that  has
  5704.  more than  110 characters  for each  line, the  [T] button  is disabled
  5705.  because all possible screens are displayed.
  5706.  
  5707.  
  5708.  
  5709.  3.6 Running multiple copies of MTA at the same time
  5710.  ───────────────────────────────────────────────────────────────────────
  5711.  You ARE able to  execute multiple copies of  MTA at the same  time when
  5712.  you run a network or  a multitasking environment like DesqView  <tm> or
  5713.  MS-Windows <tm>.
  5714.  
  5715.  To  make  it  possible  for  MTA  to  execute concurrent, you take some
  5716.  special actions:
  5717.  
  5718.  - If you use the SubstDrive option, you must make sure you use as  many
  5719.    drive-letters in this option as you are going to run multiple  copies
  5720.    of MTA;
  5721.  
  5722.  - Make  sure  the  LASTDRIVE  option  is set along with the  SubstDrive
  5723.    option;
  5724.  
  5725.  - Make sure  you have SHARE.EXE  loaded in your  machine. Without SHARE
  5726.    MTA will make a mess of things (SURE !);
  5727.  
  5728.  - Make sure  that you run  all the concurrent  copies of MTA,  all with
  5729.    their  own  TASK-number.  You  assign  a  task  number with the /TASK
  5730.    command-line option. If  you forget this,  MTA will crash  because it
  5731.    will try to use the same substituted drive for each different task;
  5732.  
  5733.  After you have setup  MTA in the way  I described above, MTA  will give
  5734.  protection for some resources:
  5735.  
  5736.  - MTA will protect all the files it uses INTERNALLY;
  5737.  
  5738.  - All  log-files  (if  they  are  the  same in all copies of MTA),  all
  5739.    temporary  files,  all  directories  and  all  substituted drives are
  5740.    either unique to the task or SHARE'ed with all other tasks;
  5741.  
  5742.  - All  external files  (like the  FILES.BBS-alike files)  are protected
  5743.    when  they  are  altered.  This  means  that these files are SHARE'ed
  5744.    within the  multiple copies  of MTA  but also  with other  tasks that
  5745.    have SHAREing options like SOME Bulletin Board Systems;
  5746.  
  5747.  - When  two MTA's  want to  access the  same file  at the same time and
  5748.    with different attributes (one WRITE,  one READ for example), one  of
  5749.    the tasks will wait until the  file is released again. To over-  come
  5750.    problems with 'eternal  waits' (called deadlocks)  you can in-  stall
  5751.    an option in MTA.CTL that will manage the maximum time MTA will  wait
  5752.    before aborting. Waiting for allocation  of a file, will also  be the
  5753.    case  with  external  files,  provided  the  'other'  task  has  used
  5754.    SHAREing attributes with the open of that file. If you want to  abort
  5755.    the waiting (and MTA along the way), you can press [CTRL-E]. In  that
  5756.    case the 'deadlock' is released an MTA will abort;
  5757.  
  5758.  Some resources can NOT be protected by MTA:
  5759.  
  5760.  - MTA  will NOT  manage anything  that happens  within the  shell's. So
  5761.    when  the  (de)compressors  run  or  when  you  are within one of the
  5762.    supplied exits,  the called  program has  to manage  the SHAREing  by
  5763.    itself.
  5764.  
  5765.  It is almost stupid to say,  but be sure to convert different  files in
  5766.  each of the copies  of MTA. Letting two  or more copies of  MTA convert
  5767.  the same files, will cause  trouble. Though SHAREing is managed,  there
  5768.  could be  cases where  MTA is  waiting for  a file  (it will do so) and
  5769.  when this MTA gets the 'GO' signal, the file could be gone  (temporary)
  5770.  because one of the other copies of MTA is working on that file.
  5771.  
  5772.  Running  multiple  MTA's   in  a  multitasking   environment  works but
  5773.  there is a  big tradeoff. When  you don't have  enough 'power' on  your
  5774.  machine,  running  two  concurrent   copies  could  take   as  long  as
  5775.  serially running these copies.  (De)compressors  are  in the  habit  to
  5776.  eat lots  of your cycles. The multi-tasker also wants to have a  little
  5777.  snack and all   are eating   more  food   than  the   PC  can   supply,
  5778.  causing  delays,    low performance and   so on.  I  have  tested  with
  5779.  several machines, but you need  at  least a   true 386-25  (or a   very
  5780.  fast  286, like  a 20Mh)  or  higher to get  good results. But  in  the
  5781.  world  where these options  of MTA   are   needed,  machine-power    is
  5782.  usually  available. Also,  when you  run   MTA   concurrent  and    you
  5783.  use   only  the   /SIM   option, performance  is  not  so  very    much
  5784.  affected  because   MTA will only perform  a decompress (usually   this
  5785.  is very   fast).  This is the    case when you  run    MTA as  an  exit
  5786.  under some  BBS program (like FileDoor <tm>).
  5787.  
  5788.  
  5789.  3.7 Compression of single executable files (PKLITE)
  5790.  ───────────────────────────────────────────────────────────────────────
  5791.  With this version  of MTA, you  can also use  MTA to do  conversions of
  5792.  executable files to compressed  (self contained) executable files  with
  5793.  PKLITE. This feature merely comes as a bonus to the program.
  5794.  
  5795.  MTA's main  goal is  to convert  archives from  a certain  system to  a
  5796.  system you  like. The  compression of  EXE/COM files  can be  used as a
  5797.  separate function.
  5798.  
  5799.  Most of the  MTA.CTL statements have  no meaning to  this type of  con-
  5800.  version. You  can setup  MTA to  do nothing  BUT conversion  of COM/EXE
  5801.  files when  you set  the CompressionType  option to  PKLITE or UNPKLITE
  5802.  but in this case you only use around 10% of the programs functions.
  5803.  
  5804.  In most cases you setup  MTA to do a archive-to-archive  conversion and
  5805.  you set CompressionType to the system  you like. If you have setup  MTA
  5806.  like this (along with all possible  options), you can still use MTA  to
  5807.  convert  COM/EXE  files  by  including   /PKLITE  or  /UNPKLITE  as   a
  5808.  command-line parameter when you call  MTA. MTA will ignore all  options
  5809.  that have  nothing to  do with  the conversion  of executable files and
  5810.  will convert COM/EXE files from normal to PKLITE or back.
  5811.  
  5812.  I did not  include LZEXE because  the latest version  I have seen  can,
  5813.  only convert from normal to LZEXE'ed and not back.  There are  programs
  5814.  that can do the reversed (LZEXE'ed to normal) but there are at least  3
  5815.  I have seen and I can not create a protected and generalized  interface
  5816.  to all of them  (also because 2 of  them come as a  shell and not as  a
  5817.  stand-alone program). This does not  mean that MTA is not  LZEXE-aware.
  5818.  When  selecting  files,  MTA  takes  into  account if a COM/EXE file is
  5819.  already compressed with LZEXE (0.90 or 0.91) and will skip the file  in
  5820.  that case. When decompressing,  MTA will only select  PKLITE-compressed
  5821.  COM/EXE files.
  5822.  
  5823.  When  you  run  MTA  without  any  file-mask,  but  WITH the /PKLITE or
  5824.  /UNPKLITE  option  (or  CompressionType  set  to  one  of  both),   the
  5825.  tag-window will also change and  will only display available files  for
  5826.  this type compression.
  5827.  
  5828.  A file is available (and usable by MTA) for PKLITE if:
  5829.  
  5830.  - It is a COM or EXE file;
  5831.  
  5832.  - If it is not compressed with PKLITE, LZEXE 0.90 or LZEXE 0.91;
  5833.  
  5834.  - If  it is  not a  self-extracting archive  (SFX) of  any of the known
  5835.    archive systems;
  5836.  
  5837.  A file is available (and usable by MTA) for UNPKLITE if:
  5838.  
  5839.  - It is a COM or EXE file;
  5840.  
  5841.  - It is compressed with PKLITE;
  5842.  
  5843.  
  5844.  3.8 The MTA tag-window
  5845.  ───────────────────────────────────────────────────────────────────────
  5846.  When you  run MTA  without any  file-masks on  the command-line,  a tag
  5847.  menu is displayed. In this tag-menu  you have the option to tag  inside
  5848.  only ONE directory. A mix of files in several different directories  is
  5849.  impossible then you use the full-screen tag.
  5850.  
  5851.  When the  tag-menu is  displayed, you  CAN switch  to other directories
  5852.  and even to  other drives. If  one or more  of the displayed  drives is
  5853.  not  available  (not  ready,  door  open,  unformatted  disk) it can be
  5854.  selected but the  tag-window will ignore  it after it  has detected any
  5855.  error on that drive. In that case you must select another drive.
  5856.  
  5857.  When you  start MTA  with SFX  support (so  you include self extracting
  5858.  archives), all files  with abnormal extensions  and COM/EXE files  that
  5859.  are  SFX-files,  will  be  included.  The  testing  will  take a while,
  5860.  depending on the speed of the drive and the machine you have.
  5861.  
  5862.  If you start MTA with the PKLITE or UNPKLITE option, all available  AND
  5863.  usable files are  displayed (so only  decompressed executable files  or
  5864.  executable files, compressed with PKLITE).
  5865.  
  5866.  If you start MTA with the GIFLITE option, all available GIF files  that
  5867.  are not  already processed  by GIFLITE  (AND which  are valid  for MTA,
  5868.  based on the MaxGIFDim option) will be shown.
  5869.  
  5870.  If you start MTA with the GIF option, all available GIF files  that are
  5871.  present will be shown (normal AND GIFLITE).
  5872.  
  5873.  If  you  start  MTA  with  the  GIF2JPG option, all available GIF files
  5874.  (again with respect  to the MaxGifDim  option) are displayed.  When you
  5875.  used the JPG2GIF option, MTA will only show (all available) JPG files.
  5876.  
  5877.  
  5878.  
  5879.  3.9 MTA and unattended operations
  5880.  ───────────────────────────────────────────────────────────────────────
  5881.  There are a number of options that influence the way that MTA works  in
  5882.  unattended mode. Most of them you  can find out when the need  is there
  5883.  but some must be pointed out.
  5884.  
  5885.  In most cases  you will do  an unattended MTA  on the same  directories
  5886.  each time over and over. First I must point out the way you must  setup
  5887.  MTA to work in the right directories. This can be done in one of the  3
  5888.  following ways:
  5889.  
  5890.  - Put the  MTA in a  batch-file, change to  the right directory  before
  5891.    you call  MTA and  call MTA  with its  options (see  later). You  can
  5892.    repeat this for every directory. For example:
  5893.  
  5894.    ..
  5895.    ..
  5896.    D:
  5897.    CD \ZIP1
  5898.    MTA [parameters]
  5899.    E:
  5900.    CD \ZIP2
  5901.    MTA [parameters]
  5902.    ..
  5903.    ..
  5904.  
  5905.    To work on \ZIP1 on D: and \ZIP2 on E:;
  5906.  
  5907.  - Make the batch smaller and  use DefaultPath options in MTA.CTL.   You
  5908.    include DefaultPath  D:\ZIP1 and  DefaultPath E:\ZIP2  in MTA.CTL and
  5909.    you can reduce the previous batch to:
  5910.  
  5911.    ..
  5912.    ..
  5913.    MTA [parameters]
  5914.    ..
  5915.    ..
  5916.  
  5917.    To work on those two directories again;
  5918.  
  5919.  - You  would like  to run  MTA on  all your  directories of  a BBS. MTA
  5920.    supports both QuickBBS  <tm> and Remote  Access <tm> BBS  types.  You
  5921.    include either the  QBBSPaths option or  the RAPaths option.   Inside
  5922.    the batch you do:
  5923.  
  5924.    ..
  5925.    ..
  5926.    MTA [parameters]
  5927.    ..
  5928.    ..
  5929.  
  5930.    And MTA will work on all files in all BBS directories.
  5931.  
  5932.  Now the next problem. You must tel  MTA to work on some files. You  can
  5933.  do this in two different ways:
  5934.  
  5935.  - Use file-masks for [parameters].  In the previous examples you  could
  5936.    tell MTA to convert  all *.ZIP and *.LZH  files (ARJ is your  target)
  5937.    with  'MTA  *.ZIP  *.LZH'  and  MTA  will convert all *.ZIP and *.LZH
  5938.    files in the supplied directories;
  5939.  
  5940.  - Use  the MarkString  and NoMarked  options (or  /MAS and  /MAR on the
  5941.    command-line).  This is a better option. In the previous example  you
  5942.    would have  problems when  someone uploaded  a *.LZS  or *.ARC  file.
  5943.    These would  not be  converted. If  you used  *.* ALL  files would be
  5944.    converted   even    those   that    you   converted    earlier    !!!
  5945.    NoMarked can be used to tell  MTA only to convert files that  confirm
  5946.    to the supplied mask AND that  are not converted before. So with  the
  5947.    NoMarked and MarkString options set,  the call to MTA can  be changed
  5948.    to 'MTA  *.*'. Only  those files  that are  not converted  before are
  5949.    converted and will not be converted again until you set the  NoMarked
  5950.    option to OFF;
  5951.  
  5952.  - Use the OnlyNewFiles option (see the description of this option);
  5953.  
  5954.  Finally there are  some options that  you must change  or include. When
  5955.  you run MTA  in unattended mode  but you don't  want MTA to  run longer
  5956.  than a  certain amount  of time  (BBS events  !!) you  can include  the
  5957.  RunTime option to limit the number of minutes that MTA can run.
  5958.  
  5959.  Remember that MTA  will start in  a new archive  even when 1  second is
  5960.  left, so  you can  outrun the  RunTime by  the time  that your  machine
  5961.  needs to convert the last archive.
  5962.  
  5963.  Sometimes you can  get frequent warnings  on some files.  In unattended
  5964.  mode these  warnings won't  be seen,  neither do  you want  to hear the
  5965.  beeping, so put a value of  0 to the WarningTime option. All  important
  5966.  things are logged (when you put  on the logging). You can also  use the
  5967.  NoBeep option to  make the execution  of MTA more  quiet. When you  run
  5968.  MTA  as  an  exit  under  a  door  (FileDoor <tm>), you should keep the
  5969.  WarningTime option (set to 1 or  higher) and you should use the  NoBeep
  5970.  option. If you set  Warningtime to 0 in  this case, the user  won't see
  5971.  any error messages !
  5972.  
  5973.  REMEMBER. ALWAYS include  a file-mask. To  call MTA without  parameters
  5974.  in unattended mode will force MTA  to display the tag-menu and to  wait
  5975.  until you enter the files.
  5976.  
  5977.  
  5978.  
  5979.  3.10 TICK files and related material
  5980.  ───────────────────────────────────────────────────────────────────────
  5981.  As you know by now, there are several options that deal with TICK  (and
  5982.  its  clone  FES)  files.  I  won't  go  into the TICKFILES option. This
  5983.  option is described in detail in the CTL-section and is only  important
  5984.  with incoming files.
  5985.  
  5986.  It  becomes  different  with  TICK/FES  files  that  are  outbound ! In
  5987.  general you  have the  following problems  when you  run MTA over files
  5988.  that are also the subject of an outgoing TICK/FES file:
  5989.  
  5990.  - The messages that are generated by TICK and FES, contain the name  of
  5991.    the archive. With a conversion from  ARC to ZIP, this will cause  the
  5992.    file to be renamed from A.ARC  to A.ZIP but the messages generated by
  5993.    TICK/FES still contain A.ARC !
  5994.  
  5995.  - The TICK/FES files  ALSO contain the name  A.ARC, so that is  another
  5996.    problem;
  5997.  
  5998.  - The TICK/FES files also contain  the CRC of the A.ARC file.  Obvious,
  5999.    when you convert  A.ARC to A.ZIP,  the CRC will  also be changed  but
  6000.    the TICK/FES files still contain the old CRC;
  6001.  
  6002.  MTA  can  deal  with  all  these  problems.  You  must  use a number of
  6003.  special options to  do so  (using  them  will cause  some overhead   on
  6004.  MTA)  but after implementing them,  you won't  have any trouble  with a
  6005.  conversion of  a file  that   is also  subject of   a TICK/FES file. In
  6006.  general, these options can also deal with other products than  TICK/FES
  6007.  if they  work in the same way.
  6008.  
  6009.  The following options must be set and will do the following:
  6010.  
  6011.  - UpdateTICKFiles and/or UpdateFESFiles
  6012.    You can add up  to 10 of EACH  options all pointing to  file-masks in
  6013.    certain directories. When you have set  up the BBS is a way  that you
  6014.    support different  TICK/FES outbound  directories for  different nets
  6015.    (or zones), you must point to all of them, for example:
  6016.  
  6017.    UpDateTickFiles D:\MAILER\OUTBOUND\TICZONE1\*.TIC
  6018.    UpDateFESFiles  D:\MAILER\OUTBOUND\TICZONE1\*.FES
  6019.    UpDateTickFiles D:\MAILER\OUTBOUND\TICZONE2\*.TIC
  6020.    UpDateTickFiles D:\MAILER\OUTBOUND\TICZONE5\*.TIC
  6021.  
  6022.    When A.ARC is  converted  to  A.ZIP, MTA will   scan ALL these  files
  6023.    in the  supplied directories  and search   for hits  for A.ARC.  When
  6024.    found, A.ARC  is changed  in A.ZIP.   The TICK/FES  files are changed
  6025.    as binary  files. MTA  reads up  to 16K  of data  per file and does a
  6026.    search  on   the  changed  item.  As  a   result  of this, it  is NOT
  6027.    possible  to   use  these  options  when  the   file-name  length  is
  6028.    changed. So  a   conversion from  A.MD to  A.ARC and  reversed is NOT
  6029.    supported. The changed  files  don't  have  to   be  TICK/FES   files
  6030.    but  these  files contain the filename (obvious).  If  your   product
  6031.    also  creates  a  file  with a filename inside, MTA can still  do the
  6032.    job !
  6033.  
  6034.  Now  you  have  a choice either to use the UpdateUntypedFiles option OR
  6035.  the UpdateMSGFiles option. The choice depends on the number of messages
  6036.  that are  normally  inside the MSG-directory. If this are many messages
  6037.  (100 or more), you  should  use  the UpdateMSGFiles option. If it are a
  6038.  small number of messages, you should use the UpdateUntypedFiles option.
  6039.  The UpdateUntypedFiles  option  will update very fast but will slowdown
  6040.  MTA when there are many files (*.MSG files in this case) to search thru
  6041.  after each conversion. The  UpdateMSGFiles  is somewhat slower than the
  6042.  UpdateUntypedFiles  option  but will benefit from the fact that it only
  6043.  has to search ALL  messages  ONCE and will then update ONLY THE RELATED
  6044.  files. I will describe both:
  6045.  
  6046.  - UpdateUntypedFiles
  6047.    You can add up to 10 of these options. In our TICK/FES example,  this
  6048.    option must point to the  netmail directory (outbound) be- cause  the
  6049.    *.MSG files must also be changed. For example:
  6050.  
  6051.    UpDateUntypedFiles D:\MAILER\OUTBOUND\TICZONE1\*.MSG
  6052.    UpDateUntypedFiles D:\MAILER\OUTBOUND\TICZONE2\*.MSG
  6053.    UpDateUntypedFiles D:\MAILER\OUTBOUND\TICZONE5\*.MSG
  6054.  
  6055.    MTA will do the same with these files (obvious they are the  outbound
  6056.    messages). This option differs from  the previous 2 in the  fact that
  6057.    UpdateTICKFiles and UpdateFESFiles ALSO  change the CRC (32-bit  CRC)
  6058.    of the files and this option ONLY the file names;
  6059.  
  6060.  - UpdateMSGFiles
  6061.    You can add up to 255 of these options. In our TICK/FES example, this
  6062.    option must point to the netmail directory (outbound) where the *.MSG
  6063.    files will be. For example:
  6064.  
  6065.    UpDateMSGFiles D:\MAILER\OUTBOUND\TICZONE1\
  6066.    UpDateMSGFiles D:\MAILER\OUTBOUND\TICZONE2\
  6067.    UpDateMSGFiles D:\MAILER\OUTBOUND\TICZONE5\
  6068.  
  6069.    The result  of  these  options  will  be  the same as in the previous
  6070.    example  for  the  UpdateUntypedFiles  option  BUT  will  work  in  a
  6071.    different  way.  Where  UpdateUntypedFiles  will scan ALL *.MSG files
  6072.    after EVERY  converted  files  (this  can  slow down the process when
  6073.    there are MANY messages to  search thru), UpdateMSGFiles will work in
  6074.    he following way:
  6075.  
  6076.    - When MTA starts, MTA will  look  in ALL CONFIGURES message areas (3
  6077.      in the case of our previous example, can be up to 255);
  6078.  
  6079.    - For  every  area  whete there is at least ONE message found with an
  6080.      attached  file, MTA will create a record in a special file which is
  6081.      called  MTA$$$$$.MFA  (in  the  current  directory or the directory
  6082.      pointed to by the MTATEMPPATH option);
  6083.  
  6084.    - Each  record can contain information for message numbers 1 to 65000
  6085.      which would be enough;
  6086.  
  6087.    - Now AFTER  the  conversion  of EVERY file, MTA will search thru the
  6088.      MTA$$$$$.MFA file and  will  only  try  to change the messages that
  6089.      have attached  files  in  the message. The change will only be done
  6090.      when the filename of the  old file (f.i. A.ARC) will match the name
  6091.      in the message;
  6092.  
  6093.    - Before  termination, MTA  will  delete the MTA$$$$$.MFA file again;
  6094.  
  6095.    With this  flow  of  action, MTA will only have to check the messages
  6096.    that have files attached to them, which will normally be only a small
  6097.    percentage of the total number of messages.
  6098.  
  6099.  
  6100.  When you use the UpdateTICKFiles/UpdateFESFiles options in combination
  6101.  with the UpdateUntypedFiles/UpdateMSGFiles options to update your TICK
  6102.  or FES files (incomming and outgoing), you  should also set one of the
  6103.  two related options UpdateUntypedFULL or UpdateMSGFull.
  6104.  
  6105.  DON'T   use   this   options   when   you   don't  work with a TICK/FES
  6106.  alike  complex.    When   UpdateTICKFiles      and/or    UpdateFESFiles
  6107.  options    are present  in   MTA.CTL, MTA   will ALWAYS   calculate the
  6108.  32-bit CRC of the  source  and   the  target.   This  causes   overhead
  6109.  when there are never updates for  TICK or  FES files.  The 32-bit   CRC
  6110.  is  fast but on a big number of  files  it will still  count ! If   you
  6111.  have TICK  or FES files that  are BIGGER than 16K, please  contact  me.
  6112.  I can change MTA   to make it compatible with  files up to 64K, but  it
  6113.  will cause memory  overhead.   Only when  your seen-by   lines are   to
  6114.  many  to mention, these problems will occur !
  6115.  
  6116.  
  6117.  
  6118.  3.11 FES, yet another TICK-clone ?
  6119.  ───────────────────────────────────────────────────────────────────────
  6120.  By now you will  have seen the   word FES  several  times. In zone   2,
  6121.  net 24x, most  of the  people know  FES. FES  looks like  a  TICK-clone
  6122.  but  implements  some  nice  features   (including  its  own  type   of
  6123.  communication files,  called  *.FES)  that  are  not  found  in   TICK.
  6124.  FES  is   already  released    but   development    goes    on.    Most
  6125.  eye-catching   is the  HATCH procedure  that gives  you a user-friendly
  6126.  interface between your   files, FILES.BBS (in  AND out) and   yourself.
  6127.  FES can optionally create  FES or TICK files for a given node.
  6128.  
  6129.  If TICK is  all you want,  stay with   TICK or take  a peek at  FES. If
  6130.  you are doing distribution yourself  (so adding new files to  a chain),
  6131.  like I do,  FES could  be it.   Also, if  you have  nodes that  want  a
  6132.  large number  of files   from certain  area's,   FES can  also  come in
  6133.  handy  and there is even a FESFix option to obtain files from remote.
  6134.  
  6135.  FES can be  obtained from several  german BBS's and  the author can  be
  6136.  contacted thru FidoNet.
  6137.  
  6138.  
  6139.  
  6140.  3.12 Special ARC considerations
  6141.  ───────────────────────────────────────────────────────────────────────
  6142.  There  are   a  few   special  ARC-files.   These  are   the files that
  6143.  are normally created with a clone of ARC or with ARC 7.xx (or  whatever
  6144.  SEA likes  to  call  it).  In  MOST  cases,  these  archives  can   not
  6145.  be decompressed   with  ARC,   PAK  or   PKUNPAK  but   need a  special
  6146.  kind of program.
  6147.  
  6148.  So far  I   have NO  information   about SEA's  new   archiver and that
  6149.  will stay  that  way   unless  either  SEA   or  someone else can  give
  6150.  me full details  about  the   operation  of  this  program. Until  that
  6151.  time, SEA  eXtended   (7.xx)   archives   will   NOT   be  supported as
  6152.  OUTPUT (target) files.
  6153.  
  6154.  There  ARE  is  a   special  program  that  is   able  to EXTRACT these
  6155.  special type of   archives. It   is called   XARC.EXE and   is released
  6156.  by SEA  for PD/Shareware  (??) usage.  XARC   must be  executed without
  6157.  any parameters and  is therefore not  suitable to be  included in MTA's
  6158.  ARCPath option !
  6159.  
  6160.  The same  story goes  for some   very old  types of  archives that  are
  6161.  more or  less compatible  to the  older   ARC. An  example is the older
  6162.  ARCA and its counterpart  ARCE but  these files  will, in  general,  be
  6163.  available for decompress with ARC, PAK or PKUNPAK.
  6164.  
  6165.  From  my  point  of  view,  it  is  very difficult to support all these
  6166.  non-standard formats.   But to make  it more flexible,  I have included
  6167.  ONE options  that makes  it possible  to use  a special  un-arc program
  6168.  that will be used  for all ARC-alike archives.   You could even call  a
  6169.  special  shell  program  that  can  see  the  difference  between   all
  6170.  ARC-formats  (I  do  NOT  mean  the  difference  between  ARC,  PAK and
  6171.  PKUNPAK, MTA  can see  this for  itself) and  calls the  correct un-ARC
  6172.  procedure for  the supplied  archives.   This option  is the  UNARCPath
  6173.  option.   The program  that is  supplied in  this option  will ONLY  be
  6174.  called   for    DECOMPRESSION   and    is   called    as    PROGRAM.EXT
  6175.  DRIVE:\PATH\ARCHIVEN.AME  (no  options,  only   the  archive  and   its
  6176.  location is presented in the call).
  6177.  
  6178.  The  UNARCPATH  option  is  designed  to  be used with XARC.EXE or with
  6179.  ARCE.EXE/ARCE.COM when you don't expect eXtended SEA archives !
  6180.  
  6181.  If you include the following:
  6182.  
  6183.  ARCPATH   C:\ARC\ARC.EXE  [rest of MTA-parameters]
  6184.  UNARCPATH C:\ARC\XARC.EXE [rest of MTA-parameters]
  6185.  
  6186.  The following will happen  when MTA is called  to convert A.ARC to  the
  6187.  ARC format:
  6188.  
  6189.  - XARC.EXE (or its substitute) is called for decompress;
  6190.  - ARC.EXE  (or its substitute) is called for compress;
  6191.  
  6192.  The following will happen  when MTA is called  to convert A.ARC to  the
  6193.  ZIP (or any NON-ARC) format:
  6194.  
  6195.  - XARC.EXE  (or its substitute) is called for decompress;
  6196.  - PKZIP.EXE (or its substitute) is called for compress;
  6197.  
  6198.  Now the same  sequences without UNARCPath  set and without  XARC.EXE in
  6199.  your DOS-path:
  6200.  
  6201.  - ARC.EXE  (or its substitute) is called for decompress;
  6202.  - ARC.EXE  (or its substitute) is called for compress;
  6203.  
  6204.  and
  6205.  
  6206.  - ARC.EXE   (or its substitute) is called for decompress;
  6207.  - PKZIP.EXE (or its substitute) is called for compress;
  6208.  
  6209.  The latter can  result in errors  when A.ARC is  a SEA eXtended  (7.xx)
  6210.  archive. The first examples will run fine !
  6211.  
  6212.  If you think this is all, then read on. It will become rather messy.
  6213.  In their development, NoGate (PAK) and SEA (ARC) have both found it
  6214.  the correct procedure to keep the internal archive format the same
  6215.  (understandable, you will be backward compatible), but they both use
  6216.  the archive version-number 10 (and maybe higher on SEA's format, but
  6217.  information is not available to me) for their extended format. In the
  6218.  NoGate version, 10 is crushed, in the SEA format, 10 is something else
  6219.  (eXtended in any case because XARC can decompress it). Now see what
  6220.  happens with A.ARC (an eXtended archive, containing 10 files, created
  6221.  with ARC 7.xx):
  6222.  
  6223.  - A.ARC contains 10 files all with code 10;
  6224.  
  6225.  - Code 10 is PAK crushed;
  6226.  
  6227.  - PAK.EXE with extract is called to decompress the archive;
  6228.  
  6229.  - The  result is  an archive  in error  and not  converted because  PAK
  6230.    terminates with error 'CRC error in data' or something else;
  6231.  
  6232.  Nothing can keep me from thinking that the same COULD also be the  case
  6233.  for code 11 (NoGate destilled, SEA  whatever) or even higher !   In any
  6234.  case it is a complete mess and  about 10K of coding in MTA is  consumed
  6235.  by these  little jokes.  The actual  victims are  the users who receive
  6236.  ARC 7.xx files AND PAK files.  Our dear friends in the SDN/SDS  circuit
  6237.  to name but a few !
  6238.  
  6239.  MTA fixes the problem with the ARC-version 10 and 11 with a rather  Q&D
  6240.  solution.  When  PAKPath  AND  UNARCPath  are available in MTA.CTL, MTA
  6241.  will  first  call  PAK  with  the  T  (test)  option.  If the resulting
  6242.  errorlevel is  not 0,  MTA will  use the  program you  supplied in  the
  6243.  UNARCPath option  (e.g. XARC.EXE).  If the  resulting errorlevel equals
  6244.  0, MTA will use  the program you supplied  in the PAKPath option  (e.g.
  6245.  PAK.EXE).
  6246.  
  6247.  When the PAKPAth option is NOT available and PAK.EXE is not in the  DOS
  6248.  path but A.ARC  contains files with  archive-code 10, MTA  will use the
  6249.  program supplied in UNARCPATH by default, EVEN when A.ARC was a  NoGate
  6250.  archive with crushed  files (in which  case the decompress  will result
  6251.  in an error).  When the PAKPath  option IS available  but the UNARCPath
  6252.  option is NOT, A.ARC will be  marked as a NoGate archive (even  when it
  6253.  is SEA  eXtended) and  the program  supplied in  the PAKPath  option is
  6254.  used (resulting in an  error when A.ARC was  SEA eXtended).  When  BOTH
  6255.  are NOT supplied,  MTA will give  an error because  neither PAKPath nor
  6256.  UNARCPath are present.
  6257.  
  6258.  The special  dirty tricks  that must  be executed  on these  files will
  6259.  result  in  somewhat  overhead  but  should  work full-proof. Because I
  6260.  dislike 2 versions per  day, I do the  same with archives that  contain
  6261.  only ARC-version 11 files). Normal  users should not use the  UNARCPath
  6262.  option  UNLESS  they  got  trouble.  SDS/SDN  sysops will have no other
  6263.  choice than to include them (in general).
  6264.  
  6265.  You can make up your own mind about all these special tricks that  must
  6266.  be executed to serialize an archive  in the correct way. I myself  find
  6267.  it rather strange that these mixups are created in the first place.
  6268.  
  6269.  
  6270.  3.13 Using newer versions of archivers
  6271.  ───────────────────────────────────────────────────────────────────────
  6272.  Once in a while you receive new versions of the archivers that you  use
  6273.  (or don't use). In  some cases, it is  quit a risk to  start converting
  6274.  all  files  to  the  new  version  (certainly  when  you  receive  beta
  6275.  versions) and in some other cases  you would like to see if  a specific
  6276.  new option is indeed working and giving you the expected result.
  6277.  
  6278.  UNLESS the  internal format  of the  archive is  changed, MTA  can work
  6279.  with a ALTernate set of  archive-program versions. This comes in  handy
  6280.  when you want to test the new version on various files but in the  mean
  6281.  while  you  would  like  to  convert  all  other  files  with the older
  6282.  version.
  6283.  
  6284.  All you have to do is the following:
  6285.  
  6286.  - Rename the new version (for example, you receive PKZIP/PKUNZIP  2.0ß,
  6287.    in  which  case   you  could  rename   PKZIP.EXE  to  P2ZIP.EXE   and
  6288.    PKUNZIP.EXE to P2UNZIP.EXE);
  6289.  
  6290.  - Alter the xxxPath option(s) in MTA.CTL. You must add the path to  the
  6291.    new version as the LAST parameter in the option. In this example  you
  6292.    add the path, C:\ARC\P2ZIP.EXE to  the PKZIPPath option and also  you
  6293.    add  C:\ARC\P2UNZIP.EXE  to  the  PKUNZIPPath  option. They will look
  6294.    something like:
  6295.  
  6296.    PKZIPPath   C:\ARC.PKZIP.EXE   N 200 C:\ARC\P2ZIP.EXE
  6297.    PKUNZIPPath C:\ARC.PKUNZIP.EXE N 200 C:\ARC\P2UNZIP.EXE
  6298.  
  6299.    You can do this for each and every archiver (GIF-conversion  program)
  6300.    you use;
  6301.  
  6302.  - Alter the xxxVersion option in  MTA.CTL. You must add the version  of
  6303.    the new release as the second parameter to the xxxVersion  option(s).
  6304.    In the example, you  normally use PKZIP 1.10  and will start to  test
  6305.    the PKZIP 2.01. In  this case you change  ZIPVersion so it will  have
  6306.    both values showed (ZIPVersion 110 201);
  6307.  
  6308.  When you are finished with the  changes, you can execute MTA as  normal
  6309.  to get  the 'normal'  versions of  all archivers.  When you execute MTA
  6310.  with  the  (optional)  /ALT  command-line  parameter,  MTA will look if
  6311.  there is  a second  path available  inside the  xxxPath option and will
  6312.  use THAT one.  If it is  not set, MTA  will use the  original path from
  6313.  this option (e.g. there is no new version present). After this  routine
  6314.  is  finished,  MTA  will  look  if  there  is a second value set in the
  6315.  xxxVersion. If so, MTA will use that one, otherwise the original  value
  6316.  (or the default value) is used. With our example and in short:
  6317.  
  6318.  MTA *.*         will convert files, using  PKZIP/PKUNZIP (1.10)    when
  6319.                  needed, to the format you have set;
  6320.  
  6321.  MTA *.* /ALT    will  convert files, using  P2ZIP/P2UNZIP (2.01)   when
  6322.                  needed, to the format you have set;
  6323.  
  6324.  
  6325.  3.14 Lo-tek functions, calling MTA as shell under MTA
  6326.  ───────────────────────────────────────────────────────────────────────
  6327.  MTA can only call itself as  a  child (to work on arc-in-arc files). If
  6328.  you try to run MTA as a shell  of  MTA (e.g. you press [S] to shell out
  6329.  if MTA and start MTA again),  you will get a message and the second MTA
  6330.  will abort.
  6331.  
  6332.  This coding is present for a  various  number of reasons (one of the is
  6333.  the usage of SUBST functions). If  for  some reason these functions can
  6334.  not be used, MTA will give a 'lo-tek' warning  and will perform various
  6335.  other tests  to  make  sure  that  it's  own working-environment is not
  6336.  trashed by other tasks.
  6337.  
  6338.  
  6339.  3.15 TEC files
  6340.  ───────────────────────────────────────────────────────────────────────
  6341.  With every release, one or more *.TEC files will be supplied. These TEC
  6342.  files will each go deeper into some delicate subjects. The TEC files
  6343.  are based upon the most frequently asked questions. These problems can
  6344.  range from examples for simple setups to discussions about comments in
  6345.  archives.
  6346.  
  6347.  ┌───────┬─────────────────────────────────────────────────────────────┐
  6348.  │   4   │ Runtime information                                         │
  6349.  └───────┴─────────────────────────────────────────────────────────────┘
  6350.  
  6351.  4.1 Command-line parameters
  6352.  ───────────────────────────────────────────────────────────────────────
  6353.  Most of  the information  that MTA  needs is  obtained from the MTA.CTL
  6354.  configuration  file.  When  you  want  to  change  one (or some) of the
  6355.  options temporary, you can use command-line parameters to do so.
  6356.  
  6357.  The syntax to start execution of MTA is:
  6358.  
  6359.  MTA {filespec} {filespec}..{filespec} {CMD} {CMD}..{CMD}
  6360.  
  6361.  {filespec} is  the  optional  wildcard  (or complete filename) you  can
  6362.             supply. You can supply up  to 25 {filespec} values. You  can
  6363.             use the normal DOS  wildcards AND the special  wildcard that
  6364.             is supplied in  almost ALL DISP-programs.  This is the  '='.
  6365.             This wildcard  can be  used for  a shifted  test. =MTA  will
  6366.             select  files   with  the   names  doMTA.bat,   MTAtest.zip,
  6367.             newMTA.me. If you want to  include the '.', you MUST  supply
  6368.             it in the wildcard. =A.Z will include mtaA.Zip and so on.
  6369.  
  6370.             If you do  not supply a  {filespec} a full-screen  menu will
  6371.             be  shown.  This  menu  can  be  used to select files in ONE
  6372.             directory.
  6373.  
  6374.  {CMD}      You  can  (optionally)   supply  one  or more   command-line
  6375.             options  when  you  execute  MTA.  Some  of  the work like a
  6376.             toggle, some  of the  overrule options  in MTA.CTL,  some of
  6377.             them can only switch on or off in MTA.CTL.
  6378.  
  6379.             In general, the /STOSIZ, /STOCOM and /STONAM toggles work in
  6380.             the old-fashioned way, command-line options that work like a
  6381.             toggle, can be supplied in two different ways:
  6382.  
  6383.             - /CMDOPT
  6384.               With this format  you  reverse  (toggle) the option in the
  6385.               MTA.CTL file  but  you need to know for sure in what state
  6386.               the option  in  MTA.CTL  is. In  other  words, if  the FOO
  6387.               option  is set in  MTA.CTL, /FOO will switch is off. If it
  6388.               was off in MTA.CTL, /FOO will switch it to on;
  6389.  
  6390.             - /CMDOPT+ or /CMDOPT-
  6391.               With  this  format  you can explicitly switch an option on
  6392.               (with /COMOPT+)  or off (with /CMDOPT-). You don't need to
  6393.               know in what state the option in MTA.CTL is;
  6394.  
  6395.             The three switches mentioned earlier (/STONAM, /STOSIZ and
  6396.             /STOCOM) work in the old way (+ or - is NOT possible). This
  6397.             is the result of the extended format (where a name can be
  6398.             supplied along with the command-line option).
  6399.  
  6400.             A  command-line  parameter  must  start  with a slash ('/').
  6401.             Multiple command-line parameters  must be separated  with at
  6402.             least one  space. If  the command-line  parameter has  extra
  6403.             values, the  must follow  the parameter  itself WITHOUT  any
  6404.             spaces between the command-line parameter and the value.  If
  6405.             the value must  include spaces, you  must replace them  with
  6406.             the underscore character. So if you use the /M  command-line
  6407.             option to move files to C:\ZIP, you must supply /MC:\ZIP;
  6408.  
  6409.  The following command-line options are available and can be used:
  6410.  
  6411.  4.1.1 Command-line parameters that stand on their own
  6412.  ───────────────────────────────────────────────────────────────────────
  6413.  The following command-line  parameters can be  used (in special  cases)
  6414.  and they don't have any counterpart in MTA.CTL.
  6415.  
  6416.  
  6417.  ┌─────────────────────────────────────────────────────────────────────┐
  6418.  │ /?                                                                  │
  6419.  └─────────────────────────────────────────────────────────────────────┘
  6420.  Function : Using /? will  activate MTA's help system. When  this system
  6421.             is invoked, no conversion will be possible. You are shown  a
  6422.             screen where  all command-line  options are  described.  You
  6423.             can now hit the [ENTER] key and you will have the option  to
  6424.             setup the  calling sequence  for MTA.  You can  do this  for
  6425.             different options until  you have all  the options you  need
  6426.             (so you can read about  the option and its syntax  while you
  6427.             can write  it down  in the  help-screen's little note-book).
  6428.             When you have finished (use  [ESC]), the system will make  a
  6429.             batch-file, called GOMTA.BAT  with all this  options inside.
  6430.             You can  start this  batch-file (and  you can  even add some
  6431.             extra parameters to it);
  6432.  
  6433.  ┌─────────────────────────────────────────────────────────────────────┐
  6434.  │ /CTL[path]                                                          │
  6435.  │ /CTL[file]                                                          │
  6436.  └─────────────────────────────────────────────────────────────────────┘
  6437.  Function : By default,  MTA will use MTA.CTL  IF the file is  somewhere
  6438.             in  the  DOS  path  (DOS  2.x  and  higher),  in the current
  6439.             directory (all DOS versions)  or in the directory  where the
  6440.             MTA.EXE file resides (DOS  3.x and higher). If  your MTA.CTL
  6441.             does not  follow this  conventions OR  you want  to assign a
  6442.             different name for it OR  you want to use an  alternate file
  6443.             for special tasks, you can instruct MTA to use this file  if
  6444.             you supply the /CTL command-line parameter. It comes in  two
  6445.             forms. Either  you supply  a complete  path (eg.  the drive,
  6446.             directory and filename, or you just supply the filename,  if
  6447.             MTA is able to  find it in the  same was as it  can find the
  6448.             MTA.CTL (path, current directory, executed directory).
  6449.  
  6450.  ┌─────────────────────────────────────────────────────────────────────┐
  6451.  │ /TASKnn                                                             │
  6452.  └─────────────────────────────────────────────────────────────────────┘
  6453.  Function : If you  want to run multiple  (concurrent) runs of MTA,  you
  6454.             must  supply  a  task-number  to  each  of  the concurrently
  6455.             running  tasks.  By  default,  MTA  assumes that is will run
  6456.             stand alone. If  this is not  the case, you  must supply the
  6457.             /TASK switch  with a  task-number from  01 to  99. Each con-
  6458.             currently running MTA must have a different task-number !
  6459.  
  6460.  ┌─────────────────────────────────────────────────────────────────────┐
  6461.  │ /LVL0                                                               │
  6462.  │ /LVL1                                                               │
  6463.  │ /LVL2                                                               │
  6464.  │ /LVL3                                                               │
  6465.  └─────────────────────────────────────────────────────────────────────┘
  6466.  Function : There are several  command-line parameters that can be  used
  6467.             to  limit  (extend)  the  search  for files to be converted.
  6468.             The set  of /LVLx  command-line parameters  can be  used (in
  6469.             combination with  the filemask(s))  to define  WHERE MTA has
  6470.             to look for files. They  can be used as command-line  driven
  6471.             replacement for some of the options in MTA.CTL  (DefaultPath
  6472.             to name one). The search is extended in the following way:
  6473.  
  6474.             /LVL0 : The  search will be  done in the  CURRENT directory.
  6475.                     This is the  same as NOT  using any DefaultPath  (or
  6476.                     alike) option in  MTA.CTL or using  /W when you  did
  6477.                     set these options.  It can be  overruled to run  MTA
  6478.                     from  the   command-line  for   just  the    current
  6479.                     directory without having  to change the  DefaultPath
  6480.                     (or alike) options in MTA.CTL;
  6481.  
  6482.             /LVL1 : With /LVL1,  MTA will  look in  all  sub-directories
  6483.                     under (NOT INCLUDING) the current directory;
  6484.  
  6485.             /LVL2 : With /LVL2,  MTA will  look in  all  sub-directories
  6486.                     under AND the current directory;
  6487.  
  6488.             /LVL3 : With /LVL3, MTA will search the whole CURRENT  drive
  6489.                     (all directories included);
  6490.  
  6491.  ┌─────────────────────────────────────────────────────────────────────┐
  6492.  │ /@[path]                                                            │
  6493.  └─────────────────────────────────────────────────────────────────────┘
  6494.  Function : All  the  files  you  want  to  convert  can  be selected in
  6495.             several ways.  The usage  of the  /@ command-line  option is
  6496.             just  only  one  of  them.  [path]  must  point  to a drive,
  6497.             directory  and  filename  that  exists.  This file must be a
  6498.             ASCII flat-file  (created with  any normal  line-editor) and
  6499.             it must contain  one filename on  each line (any  drives and
  6500.             directories are stripped by MTA internally). All files  must
  6501.             reside  in  one  directory.  It  is allowed to use wildcards
  6502.             but, unlike the  masks you can  supply on the  command-line,
  6503.             the extension '.*' is NOT  added when you do not  supply any
  6504.             extension.   MTA  will  convert  all  these  files  (if they
  6505.             exist) after each  other. You can  use /@ when  the masks on
  6506.             the normal command-line would  exceed the maximum number  of
  6507.             bytes of a parameter list.
  6508.  
  6509. │           As an extension  to  this  option, it is now also allowed to
  6510. │           supply  various  files   with   directory-names  in  VARIOUS
  6511. │           directories  (usage  for some popular programs that call MTA
  6512. │           to convert archives). There  is  one  flaw. If  you use this
  6513. │           format, MTA will search for all supplied files in ALL of the
  6514. │           supplied directory, so:
  6515. │
  6516. │           F:\ZIP\TEST.ZIP
  6517. │           C:\TEST\WANTED.ARJ
  6518. │
  6519. │           Will force MTA to convert TEST.ZIP and WANTED.ARJ in F:\ZIP
  6520. │           and to convert TEST.ZIP and WANTED.ARJ in C:\TEST. Normally
  6521. │           this is no problem  because only one of the two will reside
  6522. │           in each directory.
  6523.  
  6524.  ┌─────────────────────────────────────────────────────────────────────┐
  6525.  │ /IP[password]                                                       │
  6526.  └─────────────────────────────────────────────────────────────────────┘
  6527.  Function : With  MTA you can  convert encrypted files.  When you select
  6528.             such files, you MUST  supply the original password  that was
  6529.             used for encryption.  You can only  supply ONE password  for
  6530.             each  execution  of  MTA,  so  when you must convert various
  6531.             files with  various passwords,  you must  do so  in separate
  6532.             runs of MTA. The password that is needed for the  decompress
  6533.             of the input-file,  is supplied with  the /IP option.  There
  6534.             is (obvious) no counterpart in MTA.CTL;
  6535.  
  6536.  ┌─────────────────────────────────────────────────────────────────────┐
  6537.  │ /OP[password]                                                       │
  6538.  │ /OP@                                                                │
  6539.  └─────────────────────────────────────────────────────────────────────┘
  6540.  Function : It is possible to  let MTA create new archives that  will be
  6541.             encrypted with  a password.  In this  case, you  must supply
  6542.             the password  for the  target files,  which is  used as  the
  6543.             password for compression IF  the target system supports  any
  6544.             encryption in this way. Any target files with passwords  are
  6545.             (optionally)  recorded  in  a  log-file  (filename  and  the
  6546.             password). There is no counterpart in MTA.CTL BUT you  could
  6547.             use the xxxCompression options  to set a fixed  password (if
  6548.             needed).
  6549.  
  6550.             When you  use /OP  with a  password, you  can also  use some
  6551.             macros  inside  [password],  in  which  case  MTA  will do a
  6552.             substitution  of  the  macros.  The  following  macros   are
  6553.             available:
  6554.  
  6555.             $JD : Replaced by julian-date number. This is the number  of
  6556.                   days, counted from the  start of the year,  so January
  6557.                   31th  will  be  date-number  31,  February 2nd will be
  6558.                   number 33 and so on;
  6559.  
  6560.             $JY : Replaced by the  year-component. These are the last  2
  6561.                   bytes of the year (so 92 for 1992);
  6562.  
  6563.             $ND : The current day   (2 positions always);
  6564.  
  6565.             $NM : The current month (2 positions always);
  6566.  
  6567.             $NY : The current year  (4 positions always);
  6568.  
  6569.             $FN : The current filename (only name, not extension)
  6570.  
  6571.             /OP$JY$JDRvh will  create a  password of  92002Rvh when used
  6572.             on January  2nd 1992.  With this  macros you  can create any
  6573.             password you like, as long  as the target password (and  the
  6574.             supplied [password]) will NOT contain any spaces.
  6575.  
  6576.             /OP@ is a special form  of password usage for output  files.
  6577.             If you supply /OP@, MTA will generate a RANDOM password  for
  6578.             every file it  converts. In this  case the logging  of these
  6579.             passwords is mandatory otherwise you would never know  which
  6580.             passwords were assigned to which files. These IS some  usage
  6581.             for this option.  You can allow  users to download  ANYTHING
  6582.             from your system but they  can only use the files  when they
  6583.             obtain the  password in  another way  (by calling  you on  a
  6584.             separate line, by paying you in which case you can send  the
  6585.             passwords by mail etc.);
  6586.  
  6587.  ┌─────────────────────────────────────────────────────────────────────┐
  6588.  │ /ALT                                                                │
  6589.  └─────────────────────────────────────────────────────────────────────┘
  6590.  Function : When you  have set  SPECIAL versions  of archivers (see  the
  6591.             xxxPath and xxxVersion options in MTA.CTL) that can be  used
  6592.             (on  request)  for  testing  or  swift  conversion,  you can
  6593.             select THESE  versions (which  are not  the normal versions)
  6594.             by  using  the  /ALT  command-line  parameter.  When /ALT is
  6595.             used, MTA will look if an alternate version of any  archiver
  6596.             is set and will, if set, this version (if needed). If  there
  6597.             is  no  special  version  set,  /ALT  will  cause the normal
  6598.             version to be  used. See the  chapter on using  new versions
  6599.             of archivers;
  6600.  
  6601.  ┌─────────────────────────────────────────────────────────────────────┐
  6602.  │ /SIM                                                                │
  6603.  └─────────────────────────────────────────────────────────────────────┘
  6604.  Function : This  option  can  be   used  to  execute  MTA in a kind  of
  6605.             simulate mode. For  each archive to  be converted, MTA  will
  6606.             do the following:
  6607.  
  6608.             - Decompress the file;
  6609.             - Scan for Virus;
  6610.             - Call exits;
  6611.  
  6612.             This option  comes in  handy when  you execute  MTA under  a
  6613.             door inside  a BBS  (FileDoor) to  look for  a virus  inside
  6614.             files,  the  moment  the  file  is  uploaded or to check you
  6615.             files  (without  a  convert)  when  a  new  virus-scanner is
  6616.             released.   There   is  no  counterpart   option  for   this
  6617.             command-line parameter in the MTA.CTL file;
  6618.  
  6619.  ┌─────────────────────────────────────────────────────────────────────┐
  6620.  │ /REMSIM                                                             │
  6621.  └─────────────────────────────────────────────────────────────────────┘
  6622.  Function : This option can be used to create a file called MTAVANSI.xxx
  6623.             (where xxx is equal  to the MTA-task number, by default this
  6624.             will be 001). After MTA  has  finished, you can use DOS TYPE
  6625.             to list the file. You  will see what otherwise a remote call
  6626.             would have seen when  MTA  would  have been used under a BBS
  6627.             door (like  FileDoor  <tm>). You  can  use several runs with
  6628.             /REMSIM to adjust  the  remote  colors  to  your own taste !
  6629.  
  6630.             If you do not delete the  MTAVANSI.xxx  file  yourself,  MTA
  6631.             will append to that  file  if  /REMSIM is used again and the
  6632.             file is still in place (by  default, MTA will place the file
  6633.             in the CURRENT directory).
  6634.  
  6635.  
  6636.  ┌─────────────────────────────────────────────────────────────────────┐
  6637.  │ /DATE                                                               │
  6638.  └─────────────────────────────────────────────────────────────────────┘
  6639.  Function : This  option  can  be   used  to  execute  MTA in a kind  of
  6640.             simulate mode. For  each archive to  be converted, MTA  will
  6641.             do the following:
  6642.  
  6643.            - Test if the file matches any mask;
  6644.  
  6645.            - If it does,  test if the date  is lower than the  date that
  6646.              you supplied in the DelOldFiles option;
  6647.  
  6648.            - If it  does, manipulate the  file (delete, move)  depending
  6649.              on the DelOldPath option;
  6650.  
  6651.            This option  comes in  handy when  you execute  MTA to remove
  6652.            (without  conversion)  all  your  files  that  are too old to
  6653.            keep.
  6654.  
  6655.  ┌─────────────────────────────────────────────────────────────────────┐
  6656.  │ /ANS[type]                                                          │
  6657.  └─────────────────────────────────────────────────────────────────────┘
  6658.  Function : When this  command-line parameter  is NOT  set AND MTA  will
  6659.             use remote  logging, MTA  will use  ANSI sequences.  This is
  6660.             also  the  case  when  you  code  any  value from 1 to 9 for
  6661.             [type].  If  you  use  the  value  0 for [type] MTA will use
  6662.             ASCII for remote logging;
  6663.  
  6664.  ┌─────────────────────────────────────────────────────────────────────┐
  6665.  │ /D{=d:}                                                             │
  6666.  └─────────────────────────────────────────────────────────────────────┘
  6667.  Function : With this parameter  you instruct MTA to start  the diskette
  6668.             support as described before. There is no alternative  option
  6669.             for  it  in  MTA.CTL.   When  you  use  /D,  MTA  will start
  6670.             diskette  support  for  DRIVE  A:.   If  your  diskettes are
  6671.             accessed from another  drive (eg.   B:), you must  use /D=B:
  6672.             to do so;
  6673.  
  6674.  
  6675.  4.1.2 Command-line parameters that overrule/toggle/disable MTA.CTL
  6676.  ───────────────────────────────────────────────────────────────────────
  6677.  The following command-line parameters  will either switch an  option in
  6678.  MTA.CTL on, off  or will act  like a toggle.  Some can overrule  values
  6679.  that are set in MTA.CTL.
  6680.  
  6681.  
  6682. │┌─────────────────────────────────────────────────────────────────────┐
  6683. ││ /DEBUG{file}                                                        │
  6684. │└─────────────────────────────────────────────────────────────────────┘
  6685. │Function : See MTADEBUG.TEC inside the supplied MTA__TEC.EXE file for a
  6686. │           discription of this option.
  6687.  
  6688.  ┌─────────────────────────────────────────────────────────────────────┐
  6689.  │ /ARC                                                                │
  6690.  │ /ARJ                                                                │
  6691.  │ /ARJSFX                                                             │
  6692.  │ /DWC                                                                │
  6693.  │ /HYP                                                                │
  6694.  │ /LZH                                                                │
  6695.  │ /LZHSFX                                                             │
  6696.  │ /LZS                                                                │
  6697.  │ /MD                                                                 │
  6698.  │ /OWN                                                                │
  6699.  │ /PAK                                                                │
  6700.  │ /PAKSFX                                                             │
  6701.  │ /SQZ                                                                │
  6702.  │ /SQZSFX                                                             │
  6703.  │ /ZIP                                                                │
  6704.  │ /ZIPSFX                                                             │
  6705.  │ /ZOO                                                                │
  6706.  │ /PKLITE                                                             │
  6707.  │ /UNPKLITE                                                           │
  6708.  │ /GIFLITE                                                            │
  6709.  │ /GIF2JPG                                                            │
  6710.  │ /JPG2GIF                                                            │
  6711.  │ /GIF                                                                │
  6712.  └─────────────────────────────────────────────────────────────────────┘
  6713.  Function : Normally MTA will  convert all matched (and selected)  files
  6714.             to the system you assigned to the CompressionType option  in
  6715.             MTA.CTL. With these  command-line switches you  can overrule
  6716.             them with another format  (see CompressionType option for  a
  6717.             description of the various supported targets);
  6718.  
  6719.  ┌─────────────────────────────────────────────────────────────────────┐
  6720.  │ /NO4DOS                                                             │
  6721.  └─────────────────────────────────────────────────────────────────────┘
  6722.  Function : When you  run under  4DOS <tm>  and you  want to  use  MTA's
  6723.             internal move  options, you   can overrule  the 4DOS    <tm>
  6724.             MOVE command   with   this   parameter.   It   has the  same
  6725.             meaning  as  when  you  include  the  Not4DOSAware option in
  6726.             MTA.CTL.
  6727.  
  6728.  ┌─────────────────────────────────────────────────────────────────────┐
  6729.  │ /W{directory}                                                       │
  6730.  └─────────────────────────────────────────────────────────────────────┘
  6731.  Function : When you  have included  DefaultPath (or  alike) options  in
  6732.             MTA.CTL, or you wish  to convert files in  another directory
  6733.             as the current, you can include /W. /W by itself will  over-
  6734.             rule  any  DefaultPath  (or  alike,  like RAPaths) option in
  6735.             MTA.CTL  and  will  force  MTA  to  work  inside the CURRENT
  6736.             directory. /W{directory}  (so you  append a  valid directory
  6737.             to the parameter, like /WD:\ZIP)  will force MTA to work  on
  6738.             the supplied directory;
  6739.  
  6740.  ┌─────────────────────────────────────────────────────────────────────┐
  6741.  │ /TOUCHC{+days}                                                      │
  6742.  │ /TOUCHH                                                             │
  6743.  │ /TOUCHL                                                             │
  6744.  │ /TOUCHF                                                             │
  6745.  └─────────────────────────────────────────────────────────────────────┘
  6746.  Function : One of  these command-line  parameters can  be used (if  you
  6747.             use multiple at the same time, only the last will count)  to
  6748.             overrule the touching system that MTA uses. If you have  set
  6749.             a  way  of  touching  (TouchHig,  TouchCur, TouchLow) in the
  6750.             MTA.CTL,  these  parameters  can  be  used  to overrule this
  6751.             option in the following way:
  6752.  
  6753.             /TOUCHC : Converted  files  will  get the current date (or a
  6754.                       date {+days} (for example /TOUCHC+10 for +10 days)
  6755.                       away from the current-date;
  6756.  
  6757.             /TOUCHH  : The  same  as  using TouchHig in MTA.CTL (use the
  6758.                        highest date inside the archive);
  6759.  
  6760.             /TOUCHL : The  same as using TouchLow in in MTA.CTL (use the
  6761.                       lowest date inside the archive);
  6762.  
  6763.             /TOUCHF :  Files will keep the same date as they  had before
  6764.                        the conversion started;
  6765.  
  6766.  ┌─────────────────────────────────────────────────────────────────────┐
  6767.  │ /M{directory}                                                       │
  6768.  └─────────────────────────────────────────────────────────────────────┘
  6769.  Function : If you  use the MoveToDir option  in MTA.CTL you can  use /M
  6770.             on its own to make that option inactive. If you also  append
  6771.             a directory (eg. /MD:\ZIP\TRA), it will work the same as  if
  6772.             you supplied  D:\ZIP\TRA as  the directory  in this  option.
  6773.             So  /MD:\ZIP\TRA  will  move  converted  files to D:\ZIP\TRA
  6774.             even when the MoveToDir  option in MTA.CTL is  set otherwise
  6775.             or when it is not set at all;
  6776.  
  6777.  ┌─────────────────────────────────────────────────────────────────────┐
  6778.  │ /C2G[options]                                                       │
  6779.  │ /C2J[options]                                                       │
  6780.  │ /CD[options]                                                        │
  6781.  │ /CGL[options]                                                       │
  6782.  │ /CH[options]                                                        │
  6783.  │ /CHS[options]                                                       │
  6784.  │ /CJ[options]                                                        │
  6785.  │ /CJS[options]                                                       │
  6786.  │ /CL[options]                                                        │
  6787.  │ /CQ[options]                                                        │
  6788.  │ /CS[options]                                                        │
  6789.  │ /CSS[options]                                                       │
  6790.  │ /CZ[options]                                                        │
  6791.  │ /CZS[options]                                                       │
  6792.  │ /CGT[options]                                                       │
  6793.  └─────────────────────────────────────────────────────────────────────┘
  6794.  Function : For  almost all archivers  (and GIF-alike programs)  you can
  6795.             add some extra options for  each and every archiver (or  GIF
  6796.             program).  These  options  can  be  found  in MTA.CTL as the
  6797.             xxxCompression options (see over there). You can also  over-
  6798.             rule them (or add them  on the fly) with these  command-line
  6799.             parameters. [options]  must be  the added  options for  that
  6800.             archiver. Spaces must be replaced by underscore  characters,
  6801.             so '-a -z'  must be coded  as '-a_-z' (without  the quotes).
  6802.             Each of the command-line parameter stands for:
  6803.  
  6804.             - /C2G        GIF2JPG
  6805.             - /C2J        JPG2GIF
  6806.             - /CD         DWC
  6807.             - /CGL        GIFLITE
  6808.             - /CH         LZH
  6809.             - /CHS        LZH (SFX)
  6810.             - /CJ         ARJ
  6811.             - /CJS        ARJ (SFX)
  6812.             - /CL         PKLITE
  6813.             - /CQ         ZOO
  6814.             - /CS         SQZ
  6815.             - /CSS        SQZ (SFX)
  6816.             - /CZ         ZIP
  6817.             - /CZS        ZIP2EXE (ZIP SFX)
  6818.             - /CGT        GIFTEST
  6819.  
  6820.             Refer to the documentation for  each archiver to see a  list
  6821.             of non-common options that  can be used. Also  remember that
  6822.             the SFX creation is done  AFTER the compression (and NOT  at
  6823.             the  same  time,  even  if  the compression program supports
  6824.             it).   This means  that adding  something for  LZH SFX  will
  6825.             cause that it will  ONLY be used to  create the SFX and  NOT
  6826.             for  the  compression  of  the  LZH-file  (same goes for all
  6827.             other SFX's);
  6828.  
  6829.  ┌─────────────────────────────────────────────────────────────────────┐
  6830.  │ /Z{path}                                                            │
  6831.  └─────────────────────────────────────────────────────────────────────┘
  6832.  Function :  This command-line  parameter has  the same  meaning as  the
  6833.             usage of  the AutoDescription  option in  MTA.CTL. When  you
  6834.             use /Z as is, the AutoDescription option (if set) is  turned
  6835.             off and no  comments will be  added. When you  append a path
  6836.             (the drive,  directory and  filename) to  the parameter, the
  6837.             file  that  you  supply  will  be  added  as  comment to all
  6838.             converted archives that support  these comments. As such  it
  6839.             can be  used to  (temporary) add  the AutoDescription  or to
  6840.             overrule the values set in MTA.CTL;
  6841.  
  6842.  ┌─────────────────────────────────────────────────────────────────────┐
  6843.  │ /CARCOM{n}                                                          │
  6844.  └─────────────────────────────────────────────────────────────────────┘
  6845.  Function : This command-line option can be used to change the  behavior
  6846.             of the CarryComment  option in MTA.CTL  (if set).   When you
  6847.             supply /CARCOM  as is,  the CarryComment  option in  MTA.CTL
  6848.             will  be  (temporary)  switched  off.  If  you  use /CARCOMn
  6849.             (where 'n' is  the number 1,  2 or 3),  you can (re)set  the
  6850.             function of the CarryComment option for this run;
  6851.  
  6852.  ┌─────────────────────────────────────────────────────────────────────┐
  6853.  │ /AFB                                                                │
  6854.  │ /AFB- or /AFB+                                                      │
  6855.  └─────────────────────────────────────────────────────────────────────┘
  6856.  Function : This command-line parameter is a toggle for the  AddFilesBBS
  6857.             option in MTA.CTL;
  6858.  
  6859.  ┌─────────────────────────────────────────────────────────────────────┐
  6860.  │ /P                                                                  │
  6861.  └─────────────────────────────────────────────────────────────────────┘
  6862.  Function : When  you use the  /P command-line parameter,  MTA will stop
  6863.             any logging in  the normal log-file(s)  for the duration  of
  6864.             the run.
  6865.  
  6866.  ┌─────────────────────────────────────────────────────────────────────┐
  6867.  │ /DI                                                                 │
  6868.  │ /DE                                                                 │
  6869.  │ /DD                                                                 │
  6870.  └─────────────────────────────────────────────────────────────────────┘
  6871.  Function :  You can  disable the  functions of  the options IncludeFile
  6872.             (/DI), ExcludeFile  (/DE) and  the DoNot  (/DD) options with
  6873.             help of these command-line parameters;
  6874.  
  6875.  ┌─────────────────────────────────────────────────────────────────────┐
  6876.  │ /E1                                                                 │
  6877.  │ /E2                                                                 │
  6878.  │ /EB                                                                 │
  6879.  │ /EG                                                                 │
  6880.  └─────────────────────────────────────────────────────────────────────┘
  6881.  Functions : Any  exit  you   have  declared, can be disabled. /E1  will
  6882.              disable ExitBeforeFill (if set),  /E2 will do the  same for
  6883.              ExitAfterFill (if set),  /EB for ExitBetweenConversion  and
  6884.              /EG for  ExitAfterCompression. Exits  can only  be SET with
  6885.              help of options in MTA.CTL;
  6886.  
  6887.  ┌─────────────────────────────────────────────────────────────────────┐
  6888.  │ /U                                                                  │
  6889.  │ /U[filename]                                                        │
  6890.  │ /U[path]                                                            │
  6891.  └─────────────────────────────────────────────────────────────────────┘
  6892.  Function : This  command-line   parameter  comes in three flavors.  The
  6893.             first, /U, is a toggle  for the FilesBBS option in  MTA.CTL.
  6894.             /U will  disable the  option if  it was  set in  MTA.CTL and
  6895.             will enable the option if it was not set.
  6896.  
  6897.             /U[filename] will  enable the  FilesBBS option  but in  this
  6898.             case you  overrule the  filename FILES.BBS  (in the  working
  6899.             directory) with [filename].
  6900.  
  6901.             /U[path] will enable  the FilesBBS option  but in this  case
  6902.             you overrule the filename  FILES.BBS AND the fact  that this
  6903.             file  must  reside  in  EACH  working directory with [path].
  6904.             [path] is  the SINGLE  filename (with  drive and  directory)
  6905.             that MTA will update (RBBS master directory and such);
  6906.  
  6907.  ┌─────────────────────────────────────────────────────────────────────┐
  6908.  │ /NOOLD                                                              │
  6909.  └─────────────────────────────────────────────────────────────────────┘
  6910.  Function : When  you added the  DelOldFiles option to  MTA.CTL, you can
  6911.             use /NOOLD to switch the option off.
  6912.  
  6913.  ┌─────────────────────────────────────────────────────────────────────┐
  6914.  │ /UPGRADE                                                            │
  6915.  │ /UPGRADE+ or /UPGRADE-                                              │
  6916.  └─────────────────────────────────────────────────────────────────────┘
  6917.  Function : This command-line parameter is a toggle for the  OnlyUpgrade
  6918.             option in MTA.CTL;
  6919.  
  6920.  ┌─────────────────────────────────────────────────────────────────────┐
  6921.  │ /SBA                                                                │
  6922.  │ /SBA+ or /SBA-                                                      │
  6923.  └─────────────────────────────────────────────────────────────────────┘
  6924.  Function : This command-line parameter is a toggle for the  SkipBackups
  6925.             option in MTA.CTL;
  6926.  
  6927.  ┌─────────────────────────────────────────────────────────────────────┐
  6928.  │ /NFC or /NFC-                                                       │
  6929.  └─────────────────────────────────────────────────────────────────────┘
  6930.  Function : This command-line  parameter  toggles   the  FIXEDCONVERSION
  6931.             option in MTA.CTL  to  off. You  can  not toggle this option
  6932.             to ON. When FIXEDCONVERSION options are set in MTA.CTL, they
  6933.             are set ON by default.
  6934.  
  6935.  ┌─────────────────────────────────────────────────────────────────────┐
  6936.  │ /NUU or /NUU-                                                       │
  6937.  └─────────────────────────────────────────────────────────────────────┘
  6938.  Function : This command-line parameter  toggles  the UPDATEUNTYPEDFILES
  6939.             option to off (on is not possible);
  6940.  
  6941.  ┌─────────────────────────────────────────────────────────────────────┐
  6942.  │ /NUM or /NUM-                                                       │
  6943.  └─────────────────────────────────────────────────────────────────────┘
  6944.  Function : This  command-line  parameter   toggles  the  UPDATEMSGFILES
  6945.             option to off (on is not possible);
  6946.  
  6947.  ┌─────────────────────────────────────────────────────────────────────┐
  6948.  │ /NUT or /NUT-                                                       │
  6949.  └─────────────────────────────────────────────────────────────────────┘
  6950.  Function : This  command-line  parameter  toggles  the  UPDATETICKFILES
  6951.             option to off (on is not possible);
  6952.  
  6953.  ┌─────────────────────────────────────────────────────────────────────┐
  6954.  │ /NUF or /NUF-                                                       │
  6955.  └─────────────────────────────────────────────────────────────────────┘
  6956.  Function : This  command-line  parameter   toggles  the  UPDATEFESFILES
  6957.             option to off (on is not possible);
  6958.  
  6959.  ┌─────────────────────────────────────────────────────────────────────┐
  6960.  │ /NMA or /NMA-                                                       │
  6961.  └─────────────────────────────────────────────────────────────────────┘
  6962.  Function : This  command-line  parameter toggles the  MAKEARC option to
  6963.             off (on is not possible);
  6964.  
  6965.  ┌─────────────────────────────────────────────────────────────────────┐
  6966.  │ /NME or /NME-                                                       │
  6967.  └─────────────────────────────────────────────────────────────────────┘
  6968.  Function : This  command-line  parameter   toggles  the  MAKEARCEXCLUDE
  6969.             option to off (on is not possible);
  6970.  
  6971.  ┌─────────────────────────────────────────────────────────────────────┐
  6972.  │ /NOB                                                                │
  6973.  │ /NOB+ or /NOB-                                                      │
  6974.  └─────────────────────────────────────────────────────────────────────┘
  6975.  Function : This  command-line  parameter   is  a toggle for the  NoBeep
  6976.             option in MTA.CTL;
  6977.  
  6978.  ┌─────────────────────────────────────────────────────────────────────┐
  6979.  │ /NVI                                                                │
  6980.  └─────────────────────────────────────────────────────────────────────┘
  6981.  Function : This command-line parameter  will  switch of  the configured
  6982.             virus scanners for the duration of this run.
  6983.  
  6984.  ┌─────────────────────────────────────────────────────────────────────┐
  6985.  │ /NVM                                                                │
  6986.  └─────────────────────────────────────────────────────────────────────┘
  6987.  Function : This command-line parameter  will  switch of  the configured
  6988.             masks that  limit  the scan for a virus. If /NVM is supplied
  6989.             and the VirusScanner  options  are  available and active (no
  6990.             usage of /NVI), the scan  is ALWAYS  performed on EVERY file
  6991.             in EVERY archive.
  6992.  
  6993.  ┌─────────────────────────────────────────────────────────────────────┐
  6994.  │ /NOEMS                                                              │
  6995.  │ /NOXMS                                                              │
  6996.  └─────────────────────────────────────────────────────────────────────┘
  6997.  Function : This command-line  parameters can  be used  to disable   the
  6998.             usage of EMS  and/or XMS. The  same can be  done permanently
  6999.             with the NoEMS and/or NoXMS options in MTA.CTL;
  7000.  
  7001.  ┌─────────────────────────────────────────────────────────────────────┐
  7002.  │ /VMODE{mode}                                                        │
  7003.  └─────────────────────────────────────────────────────────────────────┘
  7004.  Function : /VMODE  as is, will  switch any VideoMode  option in MTA.CTL
  7005.             to OFF.  /VMode{mode} (where  {mode} is  the DECIMAL  video-
  7006.             mode) will force MTA to switch the video-card to {mode};
  7007.  
  7008.  ┌─────────────────────────────────────────────────────────────────────┐
  7009.  │ /EXTTST                                                             │
  7010.  │ /EXTTST+ or /EXTTST-                                                │
  7011.  └─────────────────────────────────────────────────────────────────────┘
  7012.  Function : /EXTTST is used  as a toggle for the  ExtendedTesting option
  7013.             in MTA.CTL.
  7014.  
  7015.  ┌─────────────────────────────────────────────────────────────────────┐
  7016.  │ /SFX                                                                │
  7017.  │ /SFX+ or /SFX-                                                      │
  7018.  └─────────────────────────────────────────────────────────────────────┘
  7019.  Function : /SFX  is  used  as  a  toggle  for  the SFXFiles option in
  7020.             MTA.CTL;
  7021.  
  7022.  ┌─────────────────────────────────────────────────────────────────────┐
  7023.  │ /LEA                                                                │
  7024.  │ /LEA+ or /LEA-                                                      │
  7025.  └─────────────────────────────────────────────────────────────────────┘
  7026.  Function : /LEA is  used as  a toggle  for the  KeepAbnormalExtensions
  7027.             option in MTA.CTL;
  7028.  
  7029.  ┌─────────────────────────────────────────────────────────────────────┐
  7030.  │ /TIM                                                                │
  7031.  └─────────────────────────────────────────────────────────────────────┘
  7032.  Function : When  you use the  /TIM command-line parameter,  you disable
  7033.             the RunTime option in MTA.CTL (if set);
  7034.  
  7035.  ┌─────────────────────────────────────────────────────────────────────┐
  7036.  │ /NEW                                                                │
  7037.  │ /NEW+ or /NEW-                                                      │
  7038.  └─────────────────────────────────────────────────────────────────────┘
  7039.  Function : /NEW is  used as  a toggle  for the  OnlyNewFiles option in
  7040.             MTA.CTL;
  7041.  
  7042.  ┌─────────────────────────────────────────────────────────────────────┐
  7043.  │ /MAR                                                                │
  7044.  │ /MAR+ or /MAR-                                                      │
  7045.  └─────────────────────────────────────────────────────────────────────┘
  7046.  Function : /MAR  is  used  as   a  toggle  for  the NoMarked option  in
  7047.             MTA.CTL;
  7048.  
  7049.  ┌─────────────────────────────────────────────────────────────────────┐
  7050.  │ /MAH{string}                                                        │
  7051.  └─────────────────────────────────────────────────────────────────────┘
  7052.  Function : If you want to  change the value for the MarkHeader  option,
  7053.             you can use the  /MAH{string} command-line option. When  you
  7054.             do  not  supply  {string},  MTA  will  be  forced to use the
  7055.             default value. When used, {string} must be 6 bytes of less;
  7056.  
  7057.  ┌─────────────────────────────────────────────────────────────────────┐
  7058.  │ /MAS{string}                                                        │
  7059.  └─────────────────────────────────────────────────────────────────────┘
  7060.  Function : If you want to  change the value for the MarkString  option,
  7061.             you can use the  /MAS{string} command-line option. When  you
  7062.             do  not  supply  {string},  MTA  will  be  forced to use the
  7063.             default  value.  When  used,  {string}  must  be 14 bytes of
  7064.             less;
  7065.  
  7066.  ┌─────────────────────────────────────────────────────────────────────┐
  7067.  │ /UNMARK                                                             │
  7068.  │ /UNMARK+ or /UNMARK-                                                │
  7069.  └─────────────────────────────────────────────────────────────────────┘
  7070.  Function : /UNMARK  is  used  as   a  toggle  for the UnMark option  in
  7071.             MTA.CTL;
  7072.  
  7073.  ┌─────────────────────────────────────────────────────────────────────┐
  7074.  │ /NOOWNMARK                                                          │
  7075.  └─────────────────────────────────────────────────────────────────────┘
  7076.  Function : /NOOWNMARK should only be used when MTA is executed under a
  7077.             protocol  driver like FIleDoor <tm> (XFD). In this case, the
  7078.             incomming (uploaded) files are checked against your own mark
  7079.             that you  use with NoMarked/MarkString. If the file contains
  7080.             the same mark, MTA will delete the file at once. This option
  7081.             will stop  those  users who download a file from you, rename
  7082.             the file to a bogus-name and upload it again. The dupe-check
  7083.             will not deny such a file, but MTA can see that it is one of
  7084.             your own files. If  you  use  /NOOWNMARK  you should make it
  7085.             sure that you are NOT using the DEFAULT  mark-string but one
  7086.             of your own !!
  7087.  
  7088.  ┌─────────────────────────────────────────────────────────────────────┐
  7089.  │ /OOA                                                                │
  7090.  │ /OOA+ or /OOA-                                                      │
  7091.  └─────────────────────────────────────────────────────────────────────┘
  7092.  Function : Using /OOA  will do  the same  as using  the  OptimizeOnSize
  7093.             option in MTA.CTL;
  7094.  
  7095.  ┌─────────────────────────────────────────────────────────────────────┐
  7096.  │ /AIA                                                                │
  7097.  │ /AIA+ or /AIA-                                                      │
  7098.  └─────────────────────────────────────────────────────────────────────┘
  7099.  Function : /AIA  is  used   as  a  toggle for the NoArcInArc  option in
  7100.             MTA.CTL;
  7101.  
  7102.  ┌─────────────────────────────────────────────────────────────────────┐
  7103.  │ /KEEPAV                                                             │
  7104.  │ /KEEPAV+ or /KEEPAV-                                                │
  7105.  └─────────────────────────────────────────────────────────────────────┘
  7106.  Function : /KEEPAV  is  used  as   a  toggle  for the KeepAV option  in
  7107.             MTA.CTL;
  7108.  
  7109.  ┌─────────────────────────────────────────────────────────────────────┐
  7110.  │ /KEEPVL                                                             │
  7111.  │ /KEEPVL+ or /KEEPVL-                                                │
  7112.  └─────────────────────────────────────────────────────────────────────┘
  7113.  Function : /KEEPVL  is  used  as   a  toggle  for the KeepVL option  in
  7114.             MTA.CTL;
  7115.  
  7116. │┌─────────────────────────────────────────────────────────────────────┐
  7117. ││ /NOCLOAK                                                            │
  7118. ││ /NOCLOAD+ or /NOCLOAK-                                              │
  7119. │└─────────────────────────────────────────────────────────────────────┘
  7120. │Function : /NOCLOAK  is  used  as  a  toggle  for the NoCloakedArchives
  7121. │           option in MTA.CTL;
  7122.  
  7123.  ┌─────────────────────────────────────────────────────────────────────┐
  7124.  │ /ALL                                                                │
  7125.  │ /ALL+ or /ALL-                                                      │
  7126.  └─────────────────────────────────────────────────────────────────────┘
  7127.  Function : /ALL is used as a toggle for the AllDisketteFiles option  in
  7128.             MTA.CTL;
  7129.  
  7130.  ┌─────────────────────────────────────────────────────────────────────┐
  7131.  │ /BAUD[baudrate]                                                     │
  7132.  │ /COM[comport]                                                       │
  7133.  │ /FOSSIL[fossilport]                                                 │
  7134.  │ /REMOTE                                                             │
  7135.  └─────────────────────────────────────────────────────────────────────┘
  7136.  Function : When MTA is used under a door inside a BBS and you want  MTA
  7137.             to keep the user informed about the current status, you  can
  7138.             use /BAUD, /COM (or /PORT) and /REMOTE (or their  equivalent
  7139.             counterparts in  MTA.CTL) to  do so.  [baudrate] can  be the
  7140.             baudrate  (locked  or  not)  or  0  (in which case NO remote
  7141.             operations will be done). [comport] can be a valid COM  port
  7142.             or 0 (in which case  no remote operations will take  place).
  7143.             [fossilport]  must  be  the  valid  fossil-port, there is no
  7144.             value to  switch remote  operations off  other than  setting
  7145.             [baudrate] to 0.  /COM is preferred.  You can use  all these
  7146.             command-line parameters (or  their counterparts in  MTA.CTL)
  7147.             but they  will do  nothing unless  the following combination
  7148.             is  made  (where  the  command-line  parameters overrule any
  7149.             options in MTA.CTL):
  7150.  
  7151.             - /BAUD (Baudrate) must be set to a non-zero value;
  7152.             - /COM  (ComPort )  ,,  ,,  ,, ,,    ,,  ,,    ,,  OR
  7153.               /FOSSIL (FossilPort) must be used;
  7154.             - /REMOTE (Remote) is used;
  7155.  
  7156.             You should  also look  into the  /ANS command-line parameter
  7157.             in the previous (sub)chapter.
  7158.  
  7159.  ┌─────────────────────────────────────────────────────────────────────┐
  7160.  │ /STOSIZ{ext}                                                        │
  7161.  └─────────────────────────────────────────────────────────────────────┘
  7162.  Function : /STOSIZ  is  used   as  a  toggle  for the  StoreSize option
  7163.             MTA.CTL. When you use this  option to SET the option  to ON,
  7164.             {ext} (optional)  can be  used to  set the  extension of the
  7165.             semaphore file  (default XS1)  to something  else (F#D  when
  7166.             running FileDoor 2.03 or older betas);
  7167.  
  7168.  ┌─────────────────────────────────────────────────────────────────────┐
  7169.  │ /STONAM{nam}                                                        │
  7170.  └─────────────────────────────────────────────────────────────────────┘
  7171.  Function : /STONAM  is  used   as  a  toggle  for the  StoreName option
  7172.             MTA.CTL. When you use this  option to SET the option  to ON,
  7173.             {nam} (optional)  can be  used to  set the  filename of  the
  7174.             semaphore  file  (default  FILEDOOR.XS2)  to  something else
  7175.             (FILEDOOR.F#D when running older FileDoor betas);
  7176.  
  7177.  ┌─────────────────────────────────────────────────────────────────────┐
  7178.  │ /STOCOM{nam}                                                        │
  7179.  └─────────────────────────────────────────────────────────────────────┘
  7180.  Function : /STOCOM is used  as  a  toggle  for the  StoreComment option
  7181.             MTA.CTL. When you use this  option to SET the option  to ON,
  7182.             {nam} (optional)   can  be   used  to   set the  name of the
  7183.             semaphore file (default FILEDOOR.XS3) to something else.
  7184.  
  7185.  
  7186.  
  7187.  
  7188.  4.1.3 Command-line parameters with a special usage
  7189.  ───────────────────────────────────────────────────────────────────────
  7190.  The following command-line parameters  are special (should not  be used
  7191.  but  are  documented  to  be  complete)  or  are only used in debugging
  7192.  situations.
  7193.  
  7194.  
  7195.  ┌─────────────────────────────────────────────────────────────────────┐
  7196.  │ /|                                                                  │
  7197.  │ />                                                                  │
  7198.  │ /<                                                                  │
  7199.  └─────────────────────────────────────────────────────────────────────┘
  7200.  Function : These options should (and can not) be used. They can not  be
  7201.             executed  from  the  DOS  command-line  because  they   have
  7202.             something to do  with piping. These  command-line parameters
  7203.             are used by MTA internally !
  7204.  
  7205.  ┌─────────────────────────────────────────────────────────────────────┐
  7206.  │ /PAUSE                                                              │
  7207.  └─────────────────────────────────────────────────────────────────────┘
  7208.  Function : Sometimes MTA will execute a program (archiver, virus  scan,
  7209.             exit  and  so  on)  and  this  programs reports an error. In
  7210.             these cases  you are  not able  to see  what happens because
  7211.             MTA  will  go  on  (after  a  warning  is given). If you use
  7212.             /PAUSE, MTA will pause  (without clearing the screen)  after
  7213.             the shell returns to MTA.  You must press [ESC] to  continue
  7214.             MTA in the normal way;
  7215.  
  7216.  
  7217.  
  7218.  4.2 Aborting MTA
  7219.  ───────────────────────────────────────────────────────────────────────
  7220.  There is only one way to abort MTA before it's normal end. When MTA  is
  7221.  busy, you  can press  [ESC]. MTA  will (in  time) display  that it will
  7222.  terminate soon.  Termination will  be done  AFTER THE  CURRENT FILE  IS
  7223.  CONVERTED !
  7224.  
  7225.  When you did  press [ESC] by  mistake, you can  always press any  other
  7226.  key  to  release  the  pending  termination.  In  that  case,  MTA will
  7227.  continue as normal.
  7228.  
  7229.  The termination option  does NOT work  when you use  the /D switch.  In
  7230.  this case you must wait until the diskette is fully converted.
  7231.  
  7232.  
  7233.  
  7234.  4.3 LOG file
  7235.  ───────────────────────────────────────────────────────────────────────
  7236.  MTA makes a log of almost  everything (unless you specify NoLog in  the
  7237.  MTA.CTL file or supply  /L as a runtime  switch).  You can  browse thru
  7238.  the log with a program like V.Buerg's LIST or with the 'good old'  TYPE
  7239.  command.
  7240.  
  7241.  The log-style can  be adjusted to  the users need  with three different
  7242.  options  (LogStyleFormat,  LogDateFormat  and  LogTimeFormat). Also you
  7243.  can combine  all possible  logs (the  'normal' log,  called MTA.LOG  by
  7244.  default, the  password log,  called MTA.PWN  by default  and the random
  7245.  password log,  called MTA.PWD  by default)  into one  log-file, because
  7246.  MTA will open  (APPEND) and close  the log for  every record it  has to
  7247.  write.
  7248.  
  7249.  Depending on the number of files  MTA has to convert, the MTA.LOG  file
  7250.  can get very large. I have  supplied a program (MTL.EXE) to solve  this
  7251.  problem. With  MTL.EXE you  can make  a statistical  review of your log
  7252.  file. In addition,  you can instruct  MTL to shorten  the log-file. MTL
  7253.  will rewrite the MTA.LOG file with only the total counters so far.  The
  7254.  next run MTL  will detect these  counters again and  adjust the current
  7255.  counters with these values.
  7256.  
  7257.  MTL depends  on the  format of  the log-file.  Therefor you  should not
  7258.  make any changes to the current  log-file, but make a copy of  the file
  7259.  and  work  on  the  copy  and  not  the original. MTL IS able to detect
  7260.  customized log-files  and will  adjust itself  to search  at the  right
  7261.  places. Also, records of a different  kind can be available in the  log
  7262.  (in case of a mailer or BBS program). MTL will skip these records  but.
  7263.  If  you  want  to  clean  the  log  with  MTL, MTL will ALSO remove all
  7264.  NON-MTA data from the log !
  7265.  
  7266.  If you get tired of the log, delete it, and MTA will create a new  one.
  7267.  When MTA calls itself as a child invocation, the child MTA does not  do
  7268.  any type of logging !
  7269.  
  7270.  
  7271.  
  7272.  4.4 Errors
  7273.  ───────────────────────────────────────────────────────────────────────
  7274.  Under some conditions, MTA can  abort (or skip files) which  causes the
  7275.  temporary directory to  stay on disk.  Normally MTA will  try to remove
  7276.  all files  from this  temporary directory  but there  can be cases when
  7277.  this is impossible. In such cases,  MTA will report this at the  end of
  7278.  the run. In that case you  must correct the errors manually and  remove
  7279.  the  directory  (or  directories)  from  disk. Under normal conditions,
  7280.  this  will  only  take  place  with  critical errors (disk failures and
  7281.  such).
  7282.  
  7283.  ┌───────┬─────────────────────────────────────────────────────────────┐
  7284.  │   5   │ Version information and credits                             │
  7285.  └───────┴─────────────────────────────────────────────────────────────┘
  7286.  
  7287.  5.1 The BETA-team
  7288.  ───────────────────────────────────────────────────────────────────────
  7289.  Look into  the file  SUPPORT.MTA for  a full  list of  all beta-testers
  7290.  and support nodes.
  7291.  
  7292.  
  7293.  
  7294.  5.2 Credits
  7295.  ───────────────────────────────────────────────────────────────────────
  7296.  Thanks  to  the  following  people  (besides  my eternal thanks for the
  7297.  BETA team):
  7298.  
  7299.  - All   paying, registered   users. You   made it   possible to enhance
  7300.    MTA with nice features;
  7301.  
  7302.  - All users who did write me bug reports, suggestions and so on;
  7303.  
  7304.  
  7305.  
  7306.  5.3 Version history
  7307.  ───────────────────────────────────────────────────────────────────────
  7308.  ┌───────┬────────────────────────────┐
  7309.  │ 11.xx │ Sampled release info       │
  7310.  └───────┴────────────────────────────┘
  7311.   ■ Bug fixes;
  7312.  
  7313.   ■ Added   FilesBBSFormat   option,   CarryComment   option,  alternate
  7314.     CTL support, combination of /M and /D allowed;
  7315.  
  7316.  
  7317.  ┌───────┬────────────────────────────┐
  7318.  │ 12.xx │ Sample release info        │
  7319.  └───────┴────────────────────────────┘
  7320.   ■ Bug fixes;
  7321.  
  7322.   ■ All  tables  to  255   entries,  tag-menu,  /@,  /MD,    AltDisplay,
  7323.     internal swapping   (SwapPath,  NoSwap),   MDCD  support   (MDPath),
  7324.     IncludeCTL, AV-aware,  encryption   aware,  configurable   log-file,
  7325.     MTAErrorPath, extended help, mouse  aware, ITS aware and  many, many
  7326.     more changes;
  7327.  
  7328.  
  7329.  ┌───────┬────────────────────────────┐
  7330.  │ 13.xx │ Sample release info        │
  7331.  └───────┴────────────────────────────┘
  7332.   ■ MTA swapped from  free-ware to shareware so  now a small price  must
  7333.     be payed for continued usage;
  7334.  
  7335.   ■ Several bugs fixed;
  7336.  
  7337.   ■ Added support for 4DOS descriptions, EGA/VGA special text-modes
  7338.  
  7339.  
  7340.  ┌───────┬────────────────────────────┐
  7341.  │ 14.xx │ Sample release info        │
  7342.  └───────┴────────────────────────────┘
  7343.   ■ Fixed some bugs;
  7344.  
  7345.   ■ Added  support  for  volume-labels  (ZIP/ARJ),  special   log-files,
  7346.     descriptions, substituted drives  (recursive support), VGA  support,
  7347.     special selections (/LVLx),  sharing and multi-tasking  (also multi-
  7348.     MTA), ARJ, multiple  virus scanners, HYP(er),  PKLITE, menu-tagging,
  7349.     better help, LZH 2.xx support, videomode, TICK, FES, untyped  files,
  7350.     simulation, macros in  the password command-line  parameters, remote
  7351.     logging, files that are too old, XARC/ARCE, ZOO 2.xx,
  7352.  
  7353.  
  7354.  ┌───────┬────────────────────────────┐
  7355.  │ 15.01 │ Major Release              │
  7356.  └───────┴────────────────────────────┘
  7357.   ■ I did  an almost complete  rewrite of the  documentation. Many cross
  7358.     references are now explained at their proper locations, old info  is
  7359.     removed  (a  couple  of  chapters),  all  options  and  command-line
  7360.     parameters  are  revised  and  (I  hope)  better explained. The only
  7361.     thing that still is  on the list, is  an index and a  proper utility
  7362.     to create the  page numbers for  the various users.  Overall the new
  7363.     documentation is  somewhat smaller  than the  previous version while
  7364.     still giving you all relevant information;
  7365.  
  7366.   ■ The  internals of  MTA have  changed completely.  This causes MTA to
  7367.     use almost  the same  amount of  memory as  before though  there are
  7368.     many options added.  There is also  a separate overlayed  version of
  7369.     MTA  available  (MTAOVR)  that  uses  100K  less  of  (conventional)
  7370.     memory;
  7371.  
  7372.   ■ There was  a serious bug  in the RAPATHS  option logic, causing  MTA
  7373.     not  to  recognize  the  FILES.RA  file.  This is fixed. The RAPATHS
  7374.     option is  somewhat changed  in syntax  and the  RA0 and RA1 options
  7375.     are removed from MTA;
  7376.  
  7377.   ■ The  dos-shell  in  MTA  (you  know, the little window) was  getting
  7378.     somewhat old for the current state  of the technique.  The same  was
  7379.     true for  the swapping  routines. They  are all  replaced and we now
  7380.     have 4  new DOS-shell  routines in  MTA (2  non swapped,  2 swapped,
  7381.     each pair consisting of  a windowed and non-windowed  routine). This
  7382.     also  causes  archivers  that  needed  a  swap,  to  stay inside the
  7383.     DOS-window  as  were  the  non-swapped  archivers.  Because of these
  7384.     changes the  STOWBUFFER and  FORCECGA options  are removed  from MTA
  7385.     and are now obsolete;
  7386.  
  7387.   ■ Changed  the logic  for AV'ed  files. Previous  versions would  give
  7388.     errors under special conditions. This problem is fixed;
  7389.  
  7390.   ■ Fixed a problem  where MTA could make  a mess of ARJ  AV'ed archives
  7391.     (if KEEPAV was  set) in combination  with AutoDescription. If  these
  7392.     conditions  were  met  (KEEPAV,  ARJ-AV,  AutoDescription)  and  the
  7393.     target was ZIP, MTA would  add a description to the  ARJ-file, using
  7394.     internal patching techniques, causing  the target-file to be  defect
  7395.     (you could still extract them, but with a warning). This is fixed;
  7396.  
  7397.   ■ Changed  the  logic  for  SFX  files. Previous versions did  contain
  7398.     their own  logic to  remove the  SFX-header from  the archives. This
  7399.     coding is removed  and MTA should  be able to  convert SFX files  if
  7400.     the  archiver  can  extract  files  from  the  SFX'ed  file.  By  my
  7401.     knowledge,  there  is  only  one  non-standard SFX-file. This is the
  7402.     ZOO-SFX created  with a  separate program.  These files  can not  be
  7403.     converted when ZOO  is not able  to decompress files  from the *.EXE
  7404.     files.  Overall,  this  will  give  a  much more secure (and version
  7405.     independent) result;
  7406.  
  7407.   ■ The  /M  (MOVETOPATH)  command-line  parameter  could  be used  with
  7408.     invalid directory names. MTA would report errors when the  converted
  7409.     files  was  actually  moved  to  this  directory  or a file would be
  7410.     renamed (convert RA_110.ZIP to ZIP,  with /MTRA where TRA was  not a
  7411.     valid directory.  The result  was a  file TRARA_11.ZIP  and the file
  7412.     was still  in the  current directory).  This logic  has been changed
  7413.     and fixed;  MTA will  now validate  the supplied  directory and will
  7414.     abort  (before  the  conversion)  if  there  is an invalid directory
  7415.     supplied;
  7416.  
  7417.   ■ Previous versions  of MTA could  not work with  generic directories.
  7418.     You  always  had  to  include  the  full pathname (directory and the
  7419.     drive   name).   When   reading   options   from   MTA.CTL  and  the
  7420.     command-line, MTA will  now expand generic  paths (/M.. or  /Z\ZIP\)
  7421.     to full names, based on  the current directory and drive.  Be warned
  7422.     though.  If  the  generic  path  results in an expanded NON-existing
  7423.     path, MTA will abort with an error;
  7424.  
  7425.   ■ MTA would fail the extended test when ARJ files were converted  that
  7426.     contained files, archived with -t1. These files can be found in  the
  7427.     original ARJxxx.EXE distribution  file (just run  a verbose list  of
  7428.     this archive,  write down  the length  of all  files, decompress the
  7429.     file, run a  DIR and compare  the lengths) and  all other ARJ  files
  7430.     that are created with the  -t1 ARJ command-line parameter. MTA  will
  7431.     now ignore the extended test when dealing with such ARJ archives;
  7432.  
  7433.   ■ In certain cases, MTA would forget to clean the temporary  directory
  7434.     when an extended test failed. This is fixed;
  7435.  
  7436.   ■ MTA will now FULLY ignore the ARJ_SW environment variable. MTA  will
  7437.     pass a  command-line parameter  to ARJ  (2.21 and  higher) that will
  7438.     force ARJ NOT  to look at  this env.var.. All  additional options in
  7439.     this env.var. must be added to the ARJCompression option;
  7440.  
  7441.   ■ MTA will still give a beep EVEN when the WarningTime option was  set
  7442.     to 0. This is fixed;
  7443.  
  7444.   ■ CarryComment would  sometimes be unable  to find the  comment in the
  7445.     FILES.BBS alike file. Fixed;
  7446.  
  7447.   ■ The full-screen picklist would 'flicker' when you pressed F1  (help)
  7448.     more than once. Fixed;
  7449.  
  7450.   ■ Sometimes MTA would screw up  the first file inside a PAK  SFX file.
  7451.     This is fixed;
  7452.  
  7453.   ■ MTA  would truncate  the log-file  when it  became bigger  than 64K.
  7454.     This is fixed;
  7455.  
  7456.   ■ MTA  would consume  8K blocks  of conventional  memory when the TICK
  7457.     support was on. This is fixed;
  7458.  
  7459.   ■ The documented  /CO command-line parameter  (to overrule the  option
  7460.     ZOOCOMPRESSION) did cause MTA to  fail. It has now been  included in
  7461.     MTA.EXE under the name /CQ;
  7462.  
  7463.   ■ MTA would sometimes not  remove directories. This happened when  MTA
  7464.     needed to access various drives. This is fixed;
  7465.  
  7466.   ■ Sometimes  MTA  would  display  a  very huge number of  uncompressed
  7467.     bytes for ARJ files (causing MTA to skip the file if that number  of
  7468.     bytes was not available on the hard-disk). This is fixed;
  7469.  
  7470.   ■ Under  4DOS (4.0  and higher),  MTA would  show a  cursor after  the
  7471.     first MOVE. This is fixed. MTA will hide the cursor after each  call
  7472.     to an external program (4DOS is one of them);
  7473.  
  7474.   ■ Various problems  with TBSCAN 2.9,  3.1 and 3.2  are fixed (look  at
  7475.     the  new  command-line  examples  for  this scanner). When using MTA
  7476.     under  DesqView  (with  SHARE),  you  MUST  use TBSCAN 3.2 or higher
  7477.     because older versions will deny the removal of files and  directory
  7478.     that MTA  (not TBSCAN!!)  has created.  The 3.2  works fine with the
  7479.     new coding in MTA  if you (at least)  use the -compat option  of the
  7480.     TBSCAN program;
  7481.  
  7482.   ■ Various problems  with HTSCAN 1.6  (and lower). Some  of them caused
  7483.     by MTA (fixed) and one of them caused by HTSCAN. When HTSCAN has  to
  7484.     run in 200Kb or less, it would cause MTA to report that the  archive
  7485.     contained a virus. The author of HTSCAN will change this bug in  the
  7486.     next version  and MTA  can now  work with  HTSCAN's new error-levels
  7487.     because of a change in the VIRUSSCANNER option;
  7488.  
  7489.   ■ Added %D macro  in the VIRUSSCANNER option.  %P (as before) will  be
  7490.     expanded to the complete  directory to scan (without  filenames), %F
  7491.     will be  expanded to  the complete  directory plus  \*.*. %D will be
  7492.     expanded to the  last branch (node)  in the temporary  directory and
  7493.     is a relative directory. This  macro can be used in  complex network
  7494.     structures;
  7495.  
  7496.   ■ Mouse  support  in  the  main  MTA-body  is  removed.  It  is  still
  7497.     available in the full-screen  pick-list. The NOMOUSE option  and the
  7498.     /NOMOUSE command-line parameter are removed from MTA;
  7499.  
  7500.   ■ Older versions of  MTA would rename the  target file if a  file with
  7501.     the same name existed  on the target location.  You can now add  the
  7502.     OVERWRITEDUPLICATES option  to force  MTA to  overwrite such  files.
  7503.     The new target-file will overwrite a file with the same name in  the
  7504.     target directory;
  7505.  
  7506.   ■ The  /CTL  command-line  parameter  is  enhanced.  You can now  also
  7507.     supply a filename (without  path) if that file  can be found in  the
  7508.     DOS  PATH,  the  current  directory  or  the directory where MTA.EXE
  7509.     (MTAOVR.EXE) is found (last option only under DOS 3.xx and higher);
  7510.  
  7511.   ■ The EXCLUDEFILE  and DONOT options  now accept wildcards,  including
  7512.     the '=' wildcard (see documentation);
  7513.  
  7514.   ■ Remote  operations (introduced  in the  14.5x versions  of MTA)  was
  7515.     only  possible  when  the  /REMOTE  command-line parameter was used.
  7516.     The REMOTE option for MTA.CTL is added;
  7517.  
  7518.   ■ MTA  will  now  do  remote  logging (modem communications) when  the
  7519.     REMOTE option or  /REMOTE command-line parameter  is set along  with
  7520.     non-zero  values  for  BAUD  and  COM-port.  If  either of these two
  7521.     contains  a  zero  (/BAUD0  and/or  /COM0),  MTA will not use remote
  7522.     logging;
  7523.  
  7524.   ■ Added  the /ANS  command-line parameter.  Normally MTA  will do  its
  7525.     remote logging in ANSI-mode. When /ANS0 is used, MTA will use  plain
  7526.     ASCII.  /ANS1  and  higher  values  (up  to  /ANS9)  will cause ANSI
  7527.     logging;
  7528.  
  7529.   ■ Added  the  NOBEEP  option.  When  WarningTime is set to a  non-zero
  7530.     value (nice  when running  unattended BUT  WITH remote  logging) you
  7531.     can still shut down the beeps and bells;
  7532.  
  7533.   ■ Added  the  /PAUSE   command-line  parameter  (no  counterpart    in
  7534.     MTA.CTL).   When present,  MTA will  halt until  you press ESC after
  7535.     EACH call to an external program. Added for debugging;
  7536.  
  7537.   ■ Added coding so  you can abort MTA  when it is waiting  for a locked
  7538.     (shared) file. If you press CTRL-E, MTA will abort from the lock;
  7539.  
  7540.   ■ Added  the NOEMS  and NOXMS  options in  MTA.CTL and  the /NOEMS and
  7541.     /NOXMS command-line parameters, to force  MTA NOT to use EMS  and/or
  7542.     XMS while swapping itself from memory;
  7543.  
  7544.   ■ Changed the logging.  The following changes have  been made:
  7545.  
  7546.     - All  records   have   been   split   into   single-item     lines,
  7547.       containing the needed info in the smallest number of bytes;
  7548.  
  7549.     - The  errors are   now recorded  in   the normal   log-file. As   a
  7550.       result  of  this change, the  ERRORLOGPATH option is  removed from
  7551.       MTA;
  7552.  
  7553.     - MTA and MTL  work with  the new log. If you convert to  15.01, you
  7554.       must run  the previous  MTL version  (with log-compression) before
  7555.       you start  using MTA  and MTL  unless   you   do   not   need  the
  7556.       statistics  inside  the log-file;
  7557.  
  7558.     - MTA  now uses  its own  codes (MTL  will also  use them):
  7559.  
  7560.       * error message
  7561.       ! important  information
  7562.       $ extra      information
  7563.       = status     information
  7564.       ~ password   information
  7565.       # conversion information  (needed by MTL)
  7566.       @ MTL        information (created by MTL)
  7567.  
  7568.   ■ Changed   the syntax   of the   xxxPATH options   (see documentation
  7569.     for  the  current  format).  This  was   done to change the swapping
  7570.     function and  to   add   alternative   archiver  versions.    PLEASE
  7571.     READ   the documentation carefully !
  7572.  
  7573.   ■ Added a cheap  alternative to archive-marking (NOMARKED  and related
  7574.     options) with the ONLYNEWFILES  option and/or the /NEW  command-line
  7575.     parameter. Only files that are newer than the file-date of the  file
  7576.     FILES.MTA in the working directory, are converted. MTA will  (re)set
  7577.     the file FILES.MTA itself;
  7578.  
  7579.   ■ At the risk  of loosing some friend,  I include the following  text.
  7580.     It  has  become  general  practice  for  some BBS's to add their own
  7581.     AV-code to ARJ and  ZIP files. In my  views the AV-code is  meant to
  7582.     tell the user  that a certain  file is untouched  after it has  been
  7583.     created by the  author. When a  BBS includes AV-codes,  it will mean
  7584.     that the file is  untouched after it has  been created by the  SYSOP
  7585.     (not the author) and that  is ALMOST useless information. It  can be
  7586.     used  as  long  as  ORIGINAL  AV-codes  are left unaltered but it is
  7587.     misleading  users  when  original  AV-codes  ARE  altered. With this
  7588.     practice, it is almost useless  to keep AV codes inside  the archive
  7589.     because you (as user/sysop) only  have the advertisement of the  BBS
  7590.     as  added  value.  To  (partially)  overcome  this  problem, MTA now
  7591.     contains an option INCLUDEAVFILES. If this option is NOT present  in
  7592.     MTA.CTL and KEEPAV is set, all AV'ed files are still unaltered.   If
  7593.     you include one or more  INCLUDEAVFILES options, and KEEPAV is  set,
  7594.     MTA will only keep the AV code for the files that match one or  more
  7595.     of  the  INCLUDEAVFILES  file-masks.  ALL  other AV'ed files will be
  7596.     converted EVEN when  KEEPAV is set.  One of the  next minor versions
  7597.     of MTA will extend this option  in a very dynamic (and more  secure)
  7598.     way;
  7599.  
  7600.   ■ Added  dynamic swapping.  In the  previous versions  you could  only
  7601.     tell to ALWAYS swap before the  call to another program was made  or
  7602.     to NEVER swap before the call  to another program was made.   Though
  7603.     this  function  was  variable  for  each  different  (de)compression
  7604.     program, it was somewhat rough. You can now supply a minimum  number
  7605.     of bytes that  must be available  in memory (conventional).  If this
  7606.     number of  bytes (or  more) is  available, MTA  will NOT swap itself
  7607.     out of  the way.  If it  isn't available,  MTA WILL  swap before the
  7608.     call  is  made.  Dynamic  swapping  is  now available in all xxxPATH
  7609.     options  (as  a  replacement  for  the  older  SWAP  value  in these
  7610.     options) and is added to the VIRUSSCANNER and all EXITxxx options;
  7611.  
  7612.   ■ Removed  the NOSWAP  option from  MTA. It  became obsolete after the
  7613.     introduction of dynamic swapping;
  7614.  
  7615.   ■ Added alternative archive-program  versions in the xxxPATH  options.
  7616.     Added the  /ALT command-line  parameter to  activate the alternative
  7617.     versions. See the chapter about the usage of alternative versions;
  7618.  
  7619.   ■ Added  support  for  SFX  (TARGET!!)  files. You can now create  SFX
  7620.     files as  the target.  To support  this option,  the values  ZIPSFX,
  7621.     ARJSFX,  LZHSFX  and  PAKSFX  can  be  used  as  the  value  for the
  7622.     COMPRESSIONTYPE  option.  Also  the  /ZIPSFX,  /ARJSFX,  /LZHSFX and
  7623.     /PAKSFX command-line parameters can now be used. Also added are  the
  7624.     ASFCOMPRESSION,  LSFCOMPRESSION  and  ZSFCOMPRESSION  options to add
  7625.     extra parameters to the  call to the archive-program  (when creating
  7626.     SFX files). The /CJS, /CLS  and /CZS command-line parameters can  be
  7627.     used  to   over-  rule   the  ASFCOMPRESSION,   LSFCOMPRESSION   and
  7628.     ZSFCOMPRESSION options.   The ZIP2EXEPATH option  is added to  point
  7629.     to the ZIP2EXE.EXE program;
  7630.  
  7631.   ■ MTA will also convert  archives inside archives (arc-in-arc) to  SFX
  7632.     files (when one of the xxxSFX  options is set) so the customer  does
  7633.     not need any decompression program to decompress the file;
  7634.  
  7635.   ■ Added support for GIFLITE.  You can now convert normal  GIF-files to
  7636.     the GIFLITE format when the  target is set to GIFLITE.  When running
  7637.     a  GIF->GIFLITE  conversion,  no  normal  archives  can (or will) be
  7638.     converted  so  'MTA  *.ZIP  /GIFLITE'  will  have  no  meaning.   To
  7639.     implement   this    function,    the   options    GIFLITEPATH    and
  7640.     GIFLITECOMPRESSION are added as well as the 'GIFLITE' value for  the
  7641.     COMPRESSIONTYPE  option.    The  /CGL   and  /GIFLITE   command-line
  7642.     parameters are also added;
  7643.  
  7644.   ■ Added support  for GIFTEST. You  can now test  GIF-files (normal and
  7645.     lite) when the target is set  to GIF. When running GIF->GIF test  no
  7646.     normal archives can (or will) be converted so 'MTA *.ZIP /GIF'  will
  7647.     have  no   meaning.  To   implement  this   function,  the   options
  7648.     GIFTESTPATH and GTECOMPRESSION are added as well as the 'GIF'  value
  7649.     for the  COMPRESSIONTYPE option.   The /CGT  and /GIF  command- line
  7650.     parameters are also added;
  7651.  
  7652.   ■ Added support for JPEG. You can now convert normal GIF-files to  the
  7653.     JPEG format  when the  target is  set to  GIF2JPG and  you can  also
  7654.     convert JPEG  (.JPG) files  back to  GIF when  the target  is set to
  7655.     JPG2GIF.  When  running  a  GIF->JPEG  or  JPEG->GIF  conversion, no
  7656.     normal archives can (or will) be converted, so 'MTA *.ARJ  /GIF2JPG'
  7657.     will have  no meaning.   To implement  these functions,  the options
  7658.     GIF2JPGPATH,  JPG2GIFPATH,  G2JCOMPRESSION  and  J2GCOMPRESSION  are
  7659.     added,  as  well  as  the   values  GIF2JPG  and  JPG2GIF  for   the
  7660.     COMPRESSIONTYPE  option.   The  /C2J,  /C2G,  /GIF2JPG  and /JPG2GIF
  7661.     command-line parameters are also added;
  7662.  
  7663.   ■ Added the MAXGIFDIM option to narrow the selection of GIF-files  for
  7664.     GIFLITE (unregistered version of GIFLITE);
  7665.  
  7666.   ■ Changed the full-screen picklist  to include the correct files  when
  7667.     one of the GIF-alike  options is used in  MTA (you will now  see the
  7668.     usable GIF/JPG files and not archives);
  7669.  
  7670.   ■ Changed the  help-display (MTA /?)  to reflect the  new command-line
  7671.     parameters in MTA 15.01;
  7672.  
  7673.   ■ Added  logic  and  support  for  the  new  PKZIP  (1.93+)  deflating
  7674.     algorithm. MTA  will detect  these files  and will  convert them  if
  7675.     the   newer    PKZIP/PKUNZIP      is    used      (ZIPVERSION    and
  7676.     PKZIPPATH/PKUNZIPPATH set  to  1.93/2.01  values)  or  will   report
  7677.     the need  for a  higher version  of PK(UN)ZIP  is you  still use the
  7678.     1.10 (or lower);
  7679.  
  7680.   ■ /UPGRADE is changed. It can  now be used to convert from  PKZIP 1.xx
  7681.     type of archives to 2.xx (it was set to convert from 0.xx to 1.xx);
  7682.  
  7683.   ■ Added support and logic for  the new ARJ (2.30+). MTA will  not con-
  7684.     vert  backup  files  in  ARJ  archives.  You can add the SKIPBACKUPS
  7685.     option in MTA.CTL  (/SBA command-line parameter)  in which case  MTA
  7686.     will  skip  ZOO  and  ARJ  archives  that contain backup-versions of
  7687.     files. Also, the  extended testing will  be skipped if  these backup
  7688.     version are available  in the archive.  With the last  change, it is
  7689.     possible to convert  ARJ files with  backups (and also  ZOO for that
  7690.     matter). For ARJ you can choose to do a normal conversion (in  which
  7691.     case  the  backup  files  are  removed)  or  you  can  use a special
  7692.     command-line parameter in the  ARJCOMPRESSION option, in which  case
  7693.     ARJ will rename all backup-versions with a special extension;
  7694.  
  7695.   ■ Added a graphical bar when parsing the MTA.CTL;
  7696.  
  7697.  
  7698.  ┌───────┬────────────────────────────┐
  7699.  │ 15.02 │ Bug & minor release        │
  7700.  └───────┴────────────────────────────┘
  7701.   ■ MTA would report 'duplicate  file, extension changed to ...'  when a
  7702.     file was  checked with  the /SIM  mode. This  could alarm users that
  7703.     saw the message at the remote side. Fixed;
  7704.  
  7705.   ■ MTA would report 'Unable  to RmDir/MkDir/ChDir to .........' when  a
  7706.     file was  checked with  the /SIM  mode. This  could alarm users that
  7707.     saw the message at the remote side. Fixed;
  7708.  
  7709.   ■ MTA would report 'SIMULATE  MODE' and not 'SIMULATE MODE  [OVERLAY]'
  7710.     on the main  screen when the  overlayed version and  /SIM were used.
  7711.     Fixed;
  7712.  
  7713.   ■ MTA would report 'DATETEST  MODE' and not 'DATETEST MODE  [OVERLAY]'
  7714.     on the main  screen when the  overlayed version and  /SIM were used.
  7715.     Fixed;
  7716.  
  7717.   ■ MTA  /? would  always cause  a GOMTA.BAT  in the  current directory,
  7718.     even when no changes were made to the note-pad;
  7719.  
  7720.   ■ The pick-list would  display ALL files when  /GIF was used. This  is
  7721.     fixed so only .GIF files are showed;
  7722.  
  7723.   ■ Some cosmetic changes in the copyrights for the remote display;
  7724.  
  7725.   ■ The overlay  algorithm is somewhat  changed to speed  up the parsing
  7726.     of the MTA.CTL alike file;
  7727.  
  7728.   ■ Added the RemoteColor option  in MTA.CTL to alter the  remote colors
  7729.     so they can match  the BBS colors. The  default colors are the  same
  7730.     as the default colors for FileDoor <tm>;
  7731.  
  7732.  
  7733.  ┌───────┬────────────────────────────┐
  7734.  │ 15.05 │ Minor Release              │
  7735.  └───────┴────────────────────────────┘
  7736.   ■ MTA would report 'no compressor available' or something alike,  when
  7737.     ZIP files were involved. This could happen when you did not  include
  7738.     a ZIP2EXEPath option in MTA.CTL and/or ZIP2EXE.EXE was not found  in
  7739.     the DOS-path. This is fixed;
  7740.  
  7741.   ■ JPG2GIF would report  'no compressor' available or  something alike,
  7742.     when JPG  files were  involved. This  could happen  when you did not
  7743.     include a GIFTESTPath option  in MTA.CTL and/or GIFTEST.EXE  was not
  7744.     found in the DOS-path. This is fixed;
  7745.  
  7746.   ■ Under  some conditions  (errors), the  'bar' would  not display  the
  7747.     correct  values,  neither  did  some  of  the  counters.  Also  when
  7748.     multiple files were  converted and one  or more files  were invalid,
  7749.     the ratio (percentage) could  show incorrect values. This  is fixed.
  7750.     MTA will now  display counters for  invalid files (in  red) also and
  7751.     the normal  counters, ratio  and 'bar'  are modified  in the correct
  7752.     way;
  7753.  
  7754.   ■ Fixed a problem  with /P (toggle logging).  This was still a  toggle
  7755.     but could result in  errors. /P can now  only be used to  switch any
  7756.     current logging to OFF. Using the log-file, must be set in MTA.CTL;
  7757.  
  7758.   ■ Added a /NVI command-line option. When used, the virus-scanning  (of
  7759.     ALL configured scanners) will be skipped;
  7760.  
  7761.   ■ Enhanced the IncludeAVFile option. You can now (optionally)  include
  7762.     the AV-number  (security env.  number) of  the filemask.  It is  now
  7763.     possible to  filter the  correct files  from the  ones that  are not
  7764.     from the  original authors.  In the  past IncludeAVFiles  PKLTE*.EXE
  7765.     would cause PKLT113.EXE to pass  (keep its AV, when KeepAV  was also
  7766.     set) even when RVH012 was the  one that added the AV-code (and  that
  7767.     is  NOT  PKWare).  Now  you  can  add  the PKW655 code to the option
  7768.     (IncludeAVFile PKLTE*.* PKW655) to force only the keeping of the  AV
  7769.     is the file matches PKLTE*.* AND the AV-code is PKW655). Also  masks
  7770.     for the AV-code (numeric/alphanumeric masks) can be used;
  7771.  
  7772.   ■ Added the AVLogPath option which causes a log-file to be  maintained
  7773.     by MTA, that included AV-numbers  and their names (like 0000  Robert
  7774.     K Jung or PKW655 PKWare Inc). This file can be maintained by MTL;
  7775.  
  7776.   ■ Added several log-records to the normal log that have to do with  AV
  7777.     (security env.)  coded. The  values will  only be  used when  either
  7778.     AVLogPath is set OR  at least one or  more AV-codes are supplied  as
  7779.     parameters for the IncludeAVPath option(s);
  7780.  
  7781.   ■ Added the test for  the MTAOVRSZ environment variable (only  overlay
  7782.     version).  If  present  and  containing  a numeric value, this value
  7783.     will be used as overlay buffer. Using number above 56000 will  cause
  7784.     MTAOVR to run faster but will also cause MTAOVR to use more  conven-
  7785.     tional memory;
  7786.  
  7787.  
  7788.  ┌───────┬────────────────────────────┐
  7789.  │ 15.06 │ Minor Release              │
  7790.  └───────┴────────────────────────────┘
  7791.   ■ Fixed a problem with a  runtime error 200 when no valid  files could
  7792.     be processed. This is fixed (both overlay and normal version);
  7793.  
  7794.   ■ Changed the DoNot  option in a way  that you can also  supply paths.
  7795.     It is now  possible to exclude  complete directories with  the DoNot
  7796.     statement  (e.g.  DoNot  E:\TUP\DONOT\*.*)  or  partial  directories
  7797.     (e.g.  DoNot  E:\TUP\SOME\DONOT\*.ARJ).  This  option  also comes in
  7798.     handy in combination with the QBBSPaths and RAPaths option(s);
  7799.  
  7800.   ■ Added a ChildTouch  option so you can  use another type of  touching
  7801.     for nested archives;
  7802.  
  7803.  
  7804.  ┌───────┬────────────────────────────┐
  7805.  │ 15.07 │ Minor Release              │
  7806.  └───────┴────────────────────────────┘
  7807.   ■ Fixed all problems with READONLY, HIDDEN and SYSTEM files. MTA would
  7808.     not copy, delete, rename  and/or  move these files. Though they will
  7809.     not show up  in  archives very frequently, some users complained. It
  7810.     was a bug and therefore fixed;
  7811.  
  7812.   ■ Added support  for  those  virusscanners  that can only work good on
  7813.     complete  drives. Scanners  like  Central  Point  Software CPAV (1.2
  7814.     and up) can  now  be  run  in batch-mode but will run best when they
  7815.     can scan a  full  drive. In  these  cases  you  should use the SUBST
  7816.     support of  MTA (only  if  you have troubles with it, you SHOULD use
  7817.     this feature, if you HAVE problems, tell me);
  7818.  
  7819.   ■ Added examples (tested  by me or others) for Dr.Solomon's virus scan
  7820.     (FINDVIRU) and  Central  Point Software's CPAV (only 1.2 and higher,
  7821.     1.0 does  not  return  errorlevels  and I skipped 1.1, so don't know
  7822.     if this version already returns errorlevels);
  7823.  
  7824.   ■ The %D macro in the VirusScanner option was not included in the DOCs
  7825.     (it is now) and there is a much better description of all the macros
  7826.     that you can use in this option (including the new %S and %L macro);
  7827.  
  7828.  
  7829.  ┌───────┬────────────────────────────┐
  7830.  │ 15.07 │ Bug (?) Release            │
  7831.  └───────┴────────────────────────────┘
  7832.   ■ Reports got in  from  users about MTA in a OS/2 2.0ß DOS box. MTA is
  7833.     not able to find any file that the  user wants to select. This nasty
  7834.     problem *looks*  like a problem with OS/2 2.0 because the normal DOS
  7835.     (ALSO IBM PC-DOS 5.0) works fine and the problems  involved  have to
  7836.     do with DOCUMENTED interrupts and NORMAL  Turbo  Pascal  processing.
  7837.     Thanks to some willin beta-testers I was able  to track the  problem
  7838.     down. This release contains a work-around that even causes MTA to be
  7839.     somewhat smaller and still giving the same functions. Under OS/2 2.0
  7840.     DOS boxes it *should* work again (as it did with beta-testers). Look
  7841.     into HELP__ME.MTA for questions about OS/2 2.0ß because  I don't run
  7842.     this operating system and must rely on the input from users who do !
  7843.  
  7844.  
  7845.  ┌───────┬────────────────────────────┐
  7846.  │ 15.10 │ Minor Release              │
  7847.  └───────┴────────────────────────────┘
  7848.  Several requests from users have  been addressed in this release.  Also
  7849.  please read the Q&A.MTA file (if it is present inside the archive).
  7850.  
  7851.   ■ Fixed another file-selection mask  (OS2 problem) in MTA.CH1. Also  a
  7852.     couple of OS2 beta-testers have  reported me that IBM has  addressed
  7853.     the problem  and that  there is  a fix-file  in the  later OS2 betas
  7854.     that can solve the problem;
  7855.  
  7856.   ■ Added the FileIDDiz option.  When active, it will store  the comment
  7857.     inside this  file into  memory. This  comment can  later be added to
  7858.     FILES.BBS (when ADDFilesBBS  is on) and/or  into the semaphore  file
  7859.     for the protocol-driver (StoreComment and /STOCOM, see later);
  7860.  
  7861.   ■ StoreSize, StoreName  (see later) and  StoreComment (see later)  can
  7862.     now also work  when remote operation  is NOT the  case. Normally you
  7863.     should  use  the  command-line  options  (/STOSIZ, /STONAM, /STOCOM)
  7864.     when you run MTA under a  door (FileDoor). When you set the  options
  7865.     in MTA.CTL  they will  work also  when remote  operation is  NOT the
  7866.     case (again,  unless you  toggle the  options to  OFF with  the same
  7867.     command-line parameters as mentioned before);
  7868.  
  7869.   ■ StoreSize  (/STOSIZ)  has  been  expanded.  You  can now supply  the
  7870.     extension of the file (normally xxxxxxxx.XS1) when the caller  needs
  7871.     to access another extension  (FileDoor 2.03 will need  the extension
  7872.     F$D);
  7873.  
  7874.   ■ Added  the StoreName  (/STONAM) option.  It will  create a file with
  7875.     old and new names that can be used by  a  protocol-driver  like  the
  7876.     FileDoor program. Only FileDoor 3.01 (and up)  will  work  with this
  7877.     semaphore file;
  7878.  
  7879.   ■ Added the StoreComment (/STOCOM) option. It will create a file  with
  7880.     comments from the header  or FILE_ID.DIZ file. It  can be used by  a
  7881.     protocol driver to overrule (supply) the comment of uploaded  files;
  7882.  
  7883.   ■ Added  SubstOn  and  SubstOff  options  to  overrule  the   internal
  7884.     sequence  that  MTA  uses  when  paging directories to a substituted
  7885.     drive;
  7886.  
  7887.   ■ The warning for using a Substituted drive is reversed. You will  now
  7888.     get a flashy warning when NOT using a substituted drive;
  7889.  
  7890.   ■ Added  the %T  macro in  all exit-calls  that can  be used to assign
  7891.     different  batch-files  for  different  tasks (when running multiple
  7892.     tasks);
  7893.  
  7894.   ■ The call to  LABEL.COM/EXE has been removed.  MTA will now use  some
  7895.     internal coding to reset the volume-label to the original label  (or
  7896.     a dummy when no label was set), when archives contain volume  labels
  7897.     inside;
  7898.  
  7899.   ■ The  CarryComment  option  did  only  allow  the first 255 bytes  of
  7900.     archive-comments to  be carried  over to  the new  archive. This has
  7901.     been enhanced to  64K of comment.  There are several  special tricks
  7902.     involved to  deal with  ARJ-comments in  this matter  because of the
  7903.     'multi-platform' 'compatible' matter  ARJ stores the  comment inside
  7904.     the  archives  (removing  part  of  the CR/LF sequence, resulting in
  7905.     problems when carried over to other archivers);
  7906.  
  7907.  
  7908.  ┌───────┬────────────────────────────┐
  7909.  │ 15.20 │ Major sub-release          │
  7910.  └───────┴────────────────────────────┘
  7911.  Several requests from users have  been addressed in this release.  Also
  7912.  take some  time to  sort out  the *.TEC  files included  (if any)  that
  7913.  cover special subjects more deeply.
  7914.  
  7915.   ■ Fixed a problem for non-registered usage where the MTA-childs  would
  7916.     all wait for a certain time (will work on most machines);
  7917.  
  7918.   ■ Fixed a problem for non-registered usage where the MTA under  remote
  7919.     operations would wait 90 seconds. This is reduced to 10 seconds;
  7920.  
  7921.   ■ MTA could be  called twice (again within  a DOS shell of  MTA). This
  7922.     is  fixed  for  most  configurations.  Only  MTA itself can call new
  7923.     copies of MTA (child processing);
  7924.  
  7925.   ■ When  displaying  message  remote  (BBS  under a door like  FileDoor
  7926.     <tm>) MTA would not restore  the color to the original  color before
  7927.     MTA was called. This is fixed;
  7928.  
  7929.   ■ When MTA  called the FOSSIL  to init remote  operations, the display
  7930.     could be trashed  if the FOSSIL  reported itself. MTA  will now save
  7931.     and restore the screen before and after the call to the  FOSSIL-init
  7932.     routine;
  7933.  
  7934.   ■ When  running under  multi-taskers (Desqview  etc.) MTA  would still
  7935.     try  to  change  the  video-mode  if  the VIDEOMODE option was used.
  7936.     This is fixed. VIDEOMODE will have no meaning under multi-tasking;
  7937.  
  7938.   ■ Fixed a problem (enhancement)  where +-comment lines were not  moved
  7939.     along with the  original file-comment in  the FILES.BBS alike  file.
  7940.     MTA will now move these +-comment lines;
  7941.  
  7942.   ■ GIF  files were  not touched  (and kept  their original  date). When
  7943.     TouchCur (also the new format,  see later), TouchHig or TouchLow  is
  7944.     the default,  GIF files  are touched  with the  current date  (or an
  7945.     added number of days, see new TouchCur format);
  7946.  
  7947.   ■ Files that were marked in  error (in the first 'TESTING' pass)  were
  7948.     not moved to the error-directory. This is fixed;
  7949.  
  7950.   ■ OverwriteDuplicates  only worked  for converted  files. It  will now
  7951.     also work  for moving  (with overwrite)  to the  error-directory and
  7952.     (if needed) the trashcan-directory;
  7953.  
  7954.   ■ Some users were reporing  problems with the child-call. As  a result
  7955.     of the rather  short command-line (110  bytes) under DOS,  MTA could
  7956.     fail with arc-in-arc files (child calls) because a longer  parameter
  7957.     was needed.  Now MTA  will pass  the command-line  parameters to the
  7958.     child-MTA thru  a file.  The file  is placed  in the  same directory
  7959.     where  MTA.EXE  (MTAOVR.EXE)  is  placed  OR  will  be placed in the
  7960.     directory that is pointed to by the TEMP environment variable;
  7961.  
  7962.   ■ Added  routines  and  coding to  work with SQZ archives. MTA already
  7963.     supports this archiver (like PKZIP 1.93a)  to  make  testing  rather
  7964.     simple. As a result of  this new archiver, the following options are
  7965.     added to MTA.CTL:
  7966.  
  7967.     - CompressionType SQZ
  7968.     - CompressionType SQZSFX
  7969.     - SQZPath
  7970.     - SQZCompression
  7971.     _ SSFCompression
  7972.  
  7973.     Also the following command-line switches are added:
  7974.  
  7975.     - /SQZ
  7976.     - /SQZSFX
  7977.     - /CS
  7978.     - /CSS
  7979.  
  7980.     They work the same as  their  counterparts for other archive programs
  7981.     like ZIP, ARJ and LZH;
  7982.  
  7983.   ■ Added MAXPATHS option with  same functions as RAPATHS and  QBBSPATHS
  7984.     but for Maxmimus <tm>;
  7985.  
  7986.   ■ Enhanced  the RAPATHS  option to  work with  RA 0.xx,  1.0x and 1.1x
  7987.     releases  of  Remote  Access  <tm>.  Also  CD-rom  areas for RA 1.1x
  7988.     releases are detected and ignored by MTA;
  7989.  
  7990.   ■ Enhanced the  QBBSPATHS option to  work with pre  2.75 releases (the
  7991.     MTA 15.10- situation) and 2.75+  releases of QuickBBS <tm>. The  pre
  7992.     2.75  format  (FLSEARCH.CTL)  remains   the  default  for   backward
  7993.     compatibility with MTA (will be altered in a later);
  7994.  
  7995.   ■ Added the  ExcludeDirectory option that  can be used  to exclude one
  7996.     or more  directories that  come from  RAPaths, QBBSPaths  and/or the
  7997.     new MAXPaths option;
  7998.  
  7999.   ■ Added  an  example  in  MTA.CTL  to  be used with the  virus-scanner
  8000.     (commercial) that is called GOBBLER <tm>;
  8001.  
  8002.   ■ Extended the usage  of the FILEIDDIZ option.  It is now possible  to
  8003.     let MTA use one of a set of files (not just only one);
  8004.  
  8005.   ■ Relaxed  the  testing  of  the  FILE_ID.DIZ alike file. In  previous
  8006.     releases  this  caused  many  warnings.  Because of the more dynamic
  8007.     usage of  comment-files (extended  FILEIDDIZ option),  MTA will  now
  8008.     store up to  20 lines with  each having up  to 128 characters,  into
  8009.     memory without giving any warnings;
  8010.  
  8011.   ■ Added command-line parameter /REMSIM  to let MTA create a  file that
  8012.     can be  TYPE'ed and  will show  the looks  of MTA  when it  displays
  8013.     messages remote. Can be used to check color-setup;
  8014.  
  8015.   ■ Added two remote lines when MTA is not used in SIMULATE mode and will
  8016.     call a child of itself. The childs (arc-in-arc files) will  not write
  8017.     remote messages (yet);
  8018.  
  8019.   ■ Added the ReplaceComment option  and the /REPLCOM toggle to  make it
  8020.     possible  to  overrule  existing  comments  in FILES.BBS alike files
  8021.     with the comment from a comment-file (like FILE_ID.DIZ);
  8022.  
  8023.   ■ Changed  /C  into /TOUCHC, /F into  /TOUCHF, /L into /TOUCHL  and /H
  8024.     into /TOUCHH for compatibility reasons;
  8025.  
  8026.   ■ Added  a new  parameter to  TouchCur (and  the /TOUCHC  command-line
  8027.     switch) to touch files with the current date PLUS a supplied  number
  8028.     of days;
  8029.  
  8030.   ■ Enhanced  the  DelOldFiles  option  so  it can work with a  relative
  8031.     number  of  days.  The  old  format  (with  a  fixed  date) is still
  8032.     possible;
  8033.  
  8034.   ■ Added VIRUSMASK option to make it possible for MTA to only call  the
  8035.     virus-scanners when matching files (extensions) are found;
  8036.  
  8037.   ■ Added ALTMTATEMPPath to make it possible for MTA to convert  smaller
  8038.     archives on a RAM-disk (or fast drive) and to swap to another  drive
  8039.     if there is not enough room on the RAM-disk (or fast drive);
  8040.  
  8041.   ■ Added WEEKEXTENSION  option to make  it possible to  convert special
  8042.     BBS-extensions (A10, J23) in a  special way (f.i. from A20  which is
  8043.     an ARC file to Z20, which is ZIP);
  8044.  
  8045.   ■ Added NOSUBSTTEST option for special environments like networks;
  8046.  
  8047.   ■ Added %NP and  %NF macros for the  SubstOn and SubstOff options.  To
  8048.     be used for networks;
  8049.  
  8050.   ■  All  toggles  (/STOSIZ,  /STOCOM  and  /STONAM excluded) can now be
  8051.     coded in two  ways. The new  format allows to  use the /command+  or
  8052.     /command- syntax to switch options on (+) or off (-);
  8053.  
  8054.   ■ Revamped the overlayed version. It will now run somewhat faster  and
  8055.     still uses  around the  same amount  of memory.  Also added  a large
  8056.     number of  envrionment variables  for the  overlay mechanism  so the
  8057.     user can change the overlay mechanism to suit her/his own needs;
  8058.  
  8059.   ■ On  general  request,  all   new,  changed  and  deleted options  in
  8060.     MTA.CTL can now  be found in  a  special  file MTA__xxx.CTL (xxx  is
  8061.     the version for which  this file is meant).  In the next releases  I
  8062.     will keep  some of  the older  MTA__xxx.CTL files,  so when you skip
  8063.     from  version  15.20  to  15.50  you  can still use all MTA__xxx.CTL
  8064.     files that were created in-between and you are still able to  update
  8065.     your own MTA.CTL in an easy way !
  8066.  
  8067.  
  8068.  ┌───────┬────────────────────────────┐
  8069.  │ 15.21 │ Bug release                │
  8070.  └───────┴────────────────────────────┘
  8071.   ■ Some  new  routines  caused a number of cosmetic bugs. These are now
  8072.     fixed (registered users!!!). Also registered users should unpack the
  8073.     supplied MTA__REG.EXE (which contains MTAREG.EXE and MTAREG.DOC) and
  8074.     run the MTAREG.EXE file once;
  8075.  
  8076.   ■ Fixed a problem in the documentation. VirusMasks was actually called
  8077.     VirusMask (in  the  DOC  and  the example MTA.CTL). This must be the
  8078.     VirusMasks option (with an extra 's' at the end);
  8079.  
  8080.   ■ Fixed a problem in the  documentation. In the FilesBBSFormat option,
  8081.     the example  showed an  incorrect  syntax for I(tem) numbers. If you
  8082.     want to select the 4th item, I4 must be used and not 4I;
  8083.  
  8084.   ■ Fixed a problem  when  a user did not use the MTATempPath option. It
  8085.     is highly  recommended that  you use this option, but if you didn't,
  8086.     MTA 15.20  would  trash  the screen  and  ignore  ALL archives. This
  8087.     problem is fixed (and you can still run MTA without the option);
  8088.  
  8089.   ■ Added coding for the new SQZ 1.08.2. 1.08.1 is still supported but
  8090.     1.08.2 files can only be converted by MTA 15.21;
  8091.  
  8092.   ■ The needed memory for SQZ is released to a normal amount, also the
  8093.     earlier problem with SQZ's temporary file is removed (fixed in the
  8094.     new SQZ release);
  8095.  
  8096.   ■ Added coding to add comments to SQZ files (CarryComment and the
  8097.     AutoDescription option). At this moment, MTA is unable to obtain
  8098.     existing comments from SQZ files;
  8099.  
  8100.   ■ Added ReportInvalidFiles option to test filesnames inside archives
  8101.     agains DOS-device names;
  8102.  
  8103.  
  8104.  ┌───────┬────────────────────────────┐
  8105.  │ 15.30 │ Major release              │
  8106.  └───────┴────────────────────────────┘
  8107.   ■ Fixed a bug where MTA 15.20 and 15.21 would  not recognize ZOO files
  8108.     in the correct way;
  8109.  
  8110.   ■ Cleaned the archive detection  for some archive types. Could  result
  8111.     in strange files (16meg) to be converted;
  8112.  
  8113.   ■ Fixed a bug in recursive ARC/HYP usage. This could result in invalid
  8114.     actions (under rare conditions);
  8115.  
  8116.   ■ Fixed a bug in extended testing. This  would  occur  when files with
  8117.     special attributes were extracted from the archive;
  8118.  
  8119.   ■ Fixed a bug where MTA 15.02 and up would go wild when files with the
  8120.     READONLY, HIDDEN and/or SYSTEM attribute were inside any archive;
  8121.  
  8122.   ■ Fixed a bug where  /ATL WAS used in the primary MTA but any child of
  8123.     MTA (arc-in-arc) would not notice the /ALT option;
  8124.  
  8125.   ■ Fixed a  bug  in the CARRYCOMMENT logic (type 2). Comments would not
  8126.     be taken from  FILES.BBS  and  would result in wrong descriptions in
  8127.     the new archive (double headers and so on);
  8128.  
  8129.   ■ Fixed a bug in the ReportInvalidFiles option. 'Device files' with an
  8130.     extension did not match  but  DOS still allows them as deviced. This
  8131.     is now fixed. The extension is stripped before the test;
  8132.  
  8133.   ■ Under rare conditions, MTA would leave the *.MTA file in the working
  8134.     directory (most noticeable with MTA /?). This is fixed;
  8135.  
  8136.   ■ Under some  multi-tasking  programs  and on some 80486 machines, MTA
  8137.     would countdown to slow or to fast. Fixed;
  8138.  
  8139.   ■ Touching of GIF files still didn't work. This is  now fixed forever;
  8140.  
  8141.   ■ The calling sequence of PKZIP would not allow the compress of any
  8142.     READONLY file. This is fixed;
  8143.  
  8144.   ■ One archive program (for the risk  of  getting  boring,  again it is
  8145.     another  'as designed'  feature  which  can not be overruled in this
  8146.     program) will  not  allow  READONLY/HIDDEN/SYSTEM files  to be moved
  8147.     into the target archive. This is fixed with a special trap;
  8148.  
  8149.   ■ The documentation (15.21 and lower) would suggest that the SHAREWAIT
  8150.     option could be used  without a  parameter. In fact it was marked as
  8151.     an error. MTA will now ignore the  SHAREWAIT parameter when there is
  8152.     no parameter coded;
  8153.  
  8154.   ■ Some  items  in the log-file (mostly errors) could not be related to
  8155.     any file. This is fixed;
  8156.  
  8157.   ■ Fixed a bug where MTA would truncate  files-counters in an incorrect
  8158.     manner. '[00]' would be stripped but '[  ]'  wouldn't where [ovrlay]
  8159.     would be stripped again (where it should stay  inside the comment);
  8160.  
  8161.   ■ Fixed a problem  where  MTA  would go crazy if you used TAB's in the
  8162.     MTA.CTL file. Only spaces  were  allowed but MTA will now also deTAB
  8163.     any TAB-character;
  8164.  
  8165.   ■ Fixed a problem  with AV'ed files where the AV bit was set but no AV
  8166.     code was present in the archive. Pervious versions of MTA would keep
  8167.     the AV code  (without  looking  at  the Include/ExcludeAVFile), this
  8168.     version will drop the AV code;
  8169.  
  8170.   ■ Fixed a problem  with ZIP files and the AUTODESCRIPTION option. This
  8171.     could result  in  help-screens and questions from the target archive
  8172.     program;
  8173.  
  8174.   ■ Enhanced the REPROTSPECIALATTRIBUTES option, so MTA can either reset
  8175.     the  attributes  to  normal (no extra parameter) or skip the archive
  8176.     (SKIP parameter coded);
  8177.  
  8178.   ■ Enhanced the VIRUSSCANNER option. There  is now a new parameter that
  8179.     must contain a short description  of the type of scanner. It will be
  8180.     displayed in the MTA log-file and  remote, when MTA is running under
  8181.     FileDoor <tm> (or  alike  programs). You  MUST CONVERT THESE OPTIONS
  8182.     IF YOU UPGRADE FROM A PREVIOUS VERSION !
  8183.  
  8184.   ■ Added  the  FIXEDCONVERSION option  to force  one or more files to a
  8185.     fixed target-system,  independent   of   the  current  target-system
  8186.     setting. Also added the /NFC  command-line  parameter to toggle this
  8187.     option off;
  8188.  
  8189.   ■ Added  the  FILESCOUNTER  option  to tell MTA which type of counters
  8190.     (if any) are used in your FILES.BBS-alike files;
  8191.  
  8192.   ■ Added the UpdateMSGFiles  option which will convert archive names in
  8193.     netmail  messages  (TICK/FES  support) much  faster (compared to the
  8194.     UpdateUntypedFiles option) when there are a large number of messages
  8195.     to be processed;
  8196.  
  8197.   ■ Added the UpdateMSGFull  and UpdateUntypedFull options. When present,
  8198.     MTA will check both  filename  AND directoryname for a match, BEFORE
  8199.     any updating is done on the untyped or MGS file;
  8200.  
  8201.   ■ Added the LeadingSpace  option  to convert comments from FILE_ID.DIZ  t,
  8202.     (and alike)  files  to a  format  that can be used by some FILES.BBS
  8203.     list-programs;
  8204.  
  8205.   ■ The virus-check programs will now be recorded in the MTA.LOG as well
  8206.     as the resulting errorlevel. You can now check WHICH virus-checker
  8207.     marked the file as infected. On the remote side, the user can that
  8208.     various virus-checkers are called;
  8209.  
  8210.   ■ Added the ExcludeAVFile option to  make the selection of archives of
  8211.     AV's must be kept more  easy. Also  bogus AV-codes can now result in
  8212.     removal of files or placement in the error-directory;
  8213.  
  8214.   ■ Added the ExcludeFriendlyMark to make it possible to skip files from
  8215.     BBS's who  use marking and already have done to the archive what you
  8216.     would normally do yourself;
  8217.  
  8218.   ■ Added  SkipNewfiles  option  to tell MTA not to touch files before a
  8219.     certain number of days have passed);
  8220.  
  8221.   ■ Added the /NUU,  /NUM,  /NUT  and  /NUF  command-line  parameters to
  8222.     toggle the  UpdateUntypedFiles,  UpdateMSGFiles,  UpdateTICKFiles or
  8223.     UpdateFESFiles to off;
  8224.  
  8225.   ■ You can  now  code  the  optional  parameter  SUB on the EXCLUDEFILE
  8226.     option to let MTA  also  delete all matched files in sub-directories
  8227.     of the archive;
  8228.  
  8229.   ■ Added the  DefFilesBBSDesc  option to change the default description
  8230.     for new files  and  files  without  any comment. Descriptions can be
  8231.     different, based on the filename;
  8232.  
  8233.   ■ Added the LogThreshold option to let MTA return an errorlevel 100 or
  8234.     116 when the log-file has grown above a certain threshold;
  8235.  
  8236.   ■ Added  the /NOOWNMARK  command-line  parameter that can be used when
  8237.     MTA is running  under  FileDoor <tm>. It  will remove any (uploaded)
  8238.     file that has your  own mark-string at the end (obvious the file was
  8239.     obtained from your BBS and will be a duplicate with a bogus name);
  8240.  
  8241.   ■ If AddFILESBBS  is  on, MTA  will  also  try to find comments in any
  8242.     DESCRIPT.ION (4Dos <tm>) comment  files  or ????????.I?? files which
  8243.     come from FileDoor <tm>;
  8244.  
  8245.   ■ Added the MakeArc  and MakeArcExclude options to convert non-archive
  8246.     files  into  archives  when  MTA is converting other archives in the
  8247.     same run. /NMA(-) and /NME(-) can  be  used  to swith either or both
  8248.     the MakeArc and MakeArcExclude option to off;
  8249.  
  8250.   ■ Added an  example  of the  calls for the virus scanner F-PROT.EXE in
  8251.     the example for MTA.CTL;
  8252.  
  8253.   ■ Added a  default  configuration file (MTA_EASY.CTL) that can be used
  8254.     as a starting point for non-BBS usage of MTA;
  8255.  
  8256.   ■ Changed the SUBST.TEC file;
  8257.  
  8258.   ■ Changed the COMMENTS.TEC file;
  8259.  
  8260.   ■ Added the ATTRIBUT.TEC file;
  8261.  
  8262.  
  8263.  ┌───────┬────────────────────────────┐
  8264.  │ 15.35 │ Minor release              │
  8265.  └───────┴────────────────────────────┘
  8266.   ■ Fixed a  big  number  of strange bugs that were caused by one of the
  8267.     included commercial PASCAL routines. These routines weren't outdated
  8268.     but did work  incorrectly. I  now  have  included routines of my own
  8269.     that work OK (after a long period of testing). Anything from hangups
  8270.     to incorrect functions could occur is some special cases. These  all
  8271.     apply to every included program;
  8272.  
  8273.   ■ Fixed some bugs in the logic where MTA would copy comments from one
  8274.     FILES.BBS to another. This should now work fine;
  8275.  
  8276.   ■ Fixed a problem where MTA would not report the  name  of the type of
  8277.     VIRUS-scan program  into  the MTA.LOG. The name you have assigned to
  8278.     a certain VIRUS-scanner  will  now  be  showed remote and inside the
  8279.     log-file;
  8280.  
  8281.   ■ Fixed a  problem  where  MTA  would detect arc-in-arc files with the
  8282.     extension being  a  valid  archive. In  these cases MTA would try to
  8283.     extract the  file (it will still do this) and would MOVE the file to
  8284.     the error-directory  (this  is  removed). These  files were thus not
  8285.     included anymore  in  the  target-archive, which  was incorrect. Any
  8286.     incorrect file  inside  a NESTED-archive (arc-in-arc) is now left as
  8287.     it was, independent of any extraction-results;
  8288.  
  8289.   ■ Fixed various problems with AV-codes (both ZIP and ARJ). You should
  8290.     consult the AVCODES.TEC file inside the MTA__TEC.EXE archive to read
  8291.     all about the problems with AV-codes;
  8292.  
  8293.   ■ Fixed a flaw where MTA would  report 'Mask file not found' where  it
  8294.     really  meant 'No files selected'. This  would  occur if you use the
  8295.     pick-list to tag files and did not tag any file at all;
  8296.  
  8297.   ■ Fixed a  problem  where  MTA would bail out after a number of files.
  8298.     This was only the case when the UPDATEMSGFILES option was active. As
  8299.     it was, MTA kept one  file-handle  open, causing the file-handles to
  8300.     exhaust. MTA would report various problems, from invalid extractions
  8301.     to invalid files;
  8302.  
  8303.   ■ Converted the MTA package  to Borland TP 7.0. Users can  apply for a
  8304.     very special version of MTA, compiled under StonyBrook Pascal, which
  8305.     can EXECUTE overlays in EMS. This version is still under development
  8306.     but if you need such a version, please send a message to me;
  8307.  
  8308.   ■ The pick-list will always scan the directory where it is started and
  8309.     in previous releases this could not be aborted. Now you can hit ESC
  8310.     when it is taking you too long;
  8311.  
  8312.   ■ Changed the  detection  code for PKZIP 2.xx AV-files. These were not
  8313.     reported  by  earlier  MTA  versions (only PKZIP 1.93 or higher with
  8314.     included AV-codes). See  the  AVCODES.TEC  file  inside MTA__TEC.EXE
  8315.     for details;
  8316.  
  8317.   ■ Changed the  detection  code  for  SQZ 1083. This version is now able
  8318.     to  generate  AV-codes  which  can  be  detected by MTA. Also the new
  8319.     SQZ1083 structures are detected and handled correctly;
  8320.  
  8321.   ■ If you  use  the /@ command-line option (to use a file with filename
  8322.     to convert), MTA will now also swap to the supplied directory. There
  8323.     is still one flaw (see /@ documentation) of minor interrest;
  8324.  
  8325.   ■ Added a new command-line parameter /DEBUG. For details, see the file
  8326.     MTADEBUG.TEC inside the MTA__TEC.EXE file, which is included  inside
  8327.     the release archive;
  8328.  
  8329.   ■ Added a new option KEEPAVNOCODE to keep AV-codes EVEN if there is no
  8330.     AV-number available or  no  AV-owner can  be extracted. This was the
  8331.     default behaviour of all  MTA  versions BEFORE 15.30. In 15.30 I did
  8332.     change it in a way  that  these  files  were always converted (as if
  8333.     there wasn't any AV-code). If you want the pre 15.30 behaviour again
  8334.     in MTA, you can include this option;
  8335.  
  8336.   ■ Added a new  option  NOCLOAKEDARCHIVES  (in combination with the new
  8337.     command-line  parameter  /NOCLOAK)  to  detect archives that contain
  8338.     an file inside with the same name as the original archive;
  8339.  
  8340.   ■ Added an extra parameter on the MTAERRORPATH option. You can set the
  8341.     parameter if you want MTA  to terminate when there are more than the
  8342.     specified number of FILES or BYTES present in the error-directory;
  8343.  
  8344.   ■ Added coding  to  use  the ORIGINAL CJPEG.EXE and DJPEG.EXE programs
  8345.     from the  Independent  JPEG Group <tm>. The  default is still to use
  8346.     the  Handmade  Software <tm> GIF2JPEG.EXE  and JPEG2GIF.EXE programs
  8347.     but  with  the  STANDARDJPEG  option  set, you  can now also use the
  8348.     original programs;
  8349.  
  8350.   ■ The options to  overrule/add  parameters  for GIF2JPEG and JPEG2GIF
  8351.     programs, are  extended  to  80 characters to accomodate the longer
  8352.     parameters needed for CJPEG.EXE and DJPEG.EXE;
  8353.  
  8354.   ■ Added the MTV program to the MTA package. MTV is a fast file-finder
  8355.     program with macro options and with detection of archives. The old
  8356.     MTV program (which was a stand-alone package) is now obsolete and
  8357.     replaced with this shape-up version;
  8358.  
  8359.  MTA is tested with PKWare PKPAK version 3.61, PKWare ZIP version  1.10,
  8360. │PKWare ZIP version  2.04g, NoGate PAK  version 2.51, ARC  version 6.02,
  8361.  ZOO version 2.10,  DWC version 5.10,  LHarc version 1.13c/d/2.13,  LARC
  8362. │version 3.33, MDCD  version 1.0, ARJ version 2.39b, SQZ version 1.08.3,
  8363. │HYPER  version  25,  PKLITE  release  1.15,  GIFLITE version 2.01, JPEG
  8364. │version 1.5 (HandMade), JPEG4386 (JPEG Group) and GIFTEST version 4.0ß;
  8365.  
  8366.  
  8367.  5.4 Copyright, Trademarks
  8368.  ───────────────────────────────────────────────────────────────────────
  8369.  PKPAK, PKUNPAK, PKZIP and PKUNZIP are trademarks of PKWare Inc.
  8370.  PKLITE        is a trademark of PKWare Inc.
  8371.  SQZ           is a trademark of Jonas I Hammarberg.
  8372.  PAK           is a trademark of NoGate Consulting.
  8373.  ARC and XARC  are trademarks of SEA inc.
  8374.  ZOO           is a trademark of R. Dhesi.
  8375.  DWC           is a trademark of Dean W. Cooper
  8376.  LZH and LHarc are trademarks of Yoshi;
  8377.  LZS and LARC  are trademarks of K.Miki H.Okumura and K.Masuyama
  8378.  MD            is a trademark of Michael Davenport
  8379.  ARJ           is a trademark of Robert K. Jung
  8380.  HYPER         is a trademark of Peter Sawatzki and Klaus Peter Nischke
  8381.  CRA           is a trademark of DISP and donated to public domain
  8382.  DesqView      is a trademark of Quarterdeck inc.
  8383.  Windows       is a trademark of The Microsoft Corporation
  8384.  4Dos          is a trademark of J.P. Software / R.C. Conn and T. Rawson
  8385.  FrontDoor     is a trademark of J. Homrichhausen
  8386.  SCAN          is a trademark of McAfee Associates
  8387.  TBScan        is a trademark of Frans Veldman / ESaSS B.V.
  8388.  HTScan        is a trademark of Harry Thijssen
  8389.  VIRX          is a trademark of Microcom Software Division
  8390.  CPAV          is a trademark of Central Point Software
  8391.  FINDVIRU      is a trademark of S&S International
  8392.  Dr. Solomon   is a trademark of S&S International
  8393.  Gobbler       is a trademark of COMRAC
  8394.  F-PROT        is a trademark of Fridrik Skulason
  8395.  VALIDATE      is a trademark of McAfee Associates
  8396.  QuickBBS      is a trademark of Pegasus Software
  8397.  Remote Access is a trademark of Continental Software
  8398.  TICK          is a trademark of Berry Geller
  8399.  FES           is a trademark of Frank Ploenissen
  8400.  GIFLITE       is a trademark of Tsung Hu
  8401.  JPEG 1.5      is a trademark of Handmade Software Inc.
  8402.  JPEG          is a trademark of The Independent JPEG Group
  8403.  GIFTEST       is a trademark of Dave Navarro Jr.
  8404.  OS/2          is a trademark of International Business Machines (IBM)
  8405.  PC-DOS        is a trademark of International Business Machines (IBM)
  8406.  FileDoor      is a trademark of Robert W. van Hoeven
  8407.  
  8408. │MTA is written  in Borland Pascal 7.0, with help of the Turbo  Debugger
  8409. │3.0 and  makes extensive  use of  Object Professional  1.20 and OPCFI V
  8410. │16.10.    Some  routines   are  obtained   from  TurboPower's    Asynch
  8411. │Professional  1.10.   Both  STRG  and  SYS  (6.1  and  6.0a, commercial
  8412. │version) are included. Sources are edited with BRIEF 3.1;
  8413.  
  8414.  Borland Pascal      is a trademark  of Borland International
  8415.  Turbo Debugger      is a trademark  of Borland International
  8416.  Object Professional is a trademark  of TurboPower Inc.
  8417.  Asynch Professional is a trademark  of TurboPower Inc.
  8418. │Pascal+             is a trademark  of StonyBrook software Inc.
  8419.  OPCFI               is a trademark  of Robert W. van Hoeven
  8420.  STRG and SYS        are  trademarks of Eagle Performance Software
  8421.  BRIEF               is a trademark  SolutionSystem
  8422.  
  8423.  [======================== END OF DOCUMENT ============================]
  8424.